NAME

Get-DcsDistributionPlan

SYNOPSIS

Returns a distribution plan for a server in preparation of moving eligible logical disks (storage sources) to other servers without effecting virtual disk high availability. This cmdlet creates a distribution plan in order to perform the "Evacuate DataCore Server" or "Redistribute to DataCore Server" operations. Eligible virtual disks must have a storage source created from a shared pool and the destination server must share the same pool.

SYNTAX

Get-DcsDistributionPlan   -LogicalDisk <Object[]>   [ -DestinationServer <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns a distribution plan for a server in preparation of moving eligible logical disks (storage sources) to other servers without effecting virtual disk high availability. This cmdlet creates a distribution plan in order to perform the "Evacuate DataCore Server" or "Redistribute to DataCore Server" operations. Eligible virtual disks must have a storage source created from a shared pool and the destination server must share the same pool. The returned plan consists of an array of logical disk IDs with an associated server where the eligible storage sources will be moved. A warning is provided if storage sources are not eligible to be moved. Logical disks with warnings on the plan will not be moved. Actions can be taken to reduce warnings if desired and the cmdlet can be invoked again to get a new distribution plan. (See Start-DcsDistributionPlan to start the distribution of storage sources to other servers.)

PARAMETERS

-LogicalDisk<Object[]>
An array of LogicalDiskData objects, IDs or captions that identifies one or more logical disks to move. LogicalDiskData objects can be obtained from Get-DcsLogicalDisk.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-DestinationServer<Object>
ServerHostData object, computer name or ID that identifies the destination server where the storage sources should be moved and behaves in the same way as the "Redistribute to DataCore Server" operation in the user interface. The computer name must be unique or the name must be fully qualified. The ServerHostData object can be obtained from Get-DcsServer. If the DestinationServer parameter is not specified, the software will determine the best server based on balancing the load and the number of available paths and behaves in the same way as the "Evacuate DataCore Server" operation.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection is used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

LogicalDiskData [] : An array of LogicalDiskData objects that describe and identify the storage sources on a server.

OUTPUTS

LogicalDiskDistributionSet : Object that describes the distribution set which consists of an array of logical disk IDs and the associated server candidates and any warnings.

NOTES

Under certain circumstances, a distribution plan is not required, see Start-DcsDistributionPlan for more information.

EXAMPLES


-------------- Example 1 Returns the distribution plan for all storage sources on a specified server to evacuate virtual disks. --------------
$plan = Get-DcsLogicalDisk -Server SSV1 | Get-DcsDistributionPlan

This example creates a distribution plan for a "Evacuate DataCore Server" operation. The cmdlet Get-DcsLogicalDisk is invoked to obtain all LogicalDiskData objects for the server named "SSV1", which will be evacuating its logical disks. Those objects are piped to the cmdlet Get-DcsDistributionPlan to generate the distribution plan for the server "SSV1". The returned LogicalDiskDistributionSet object is saved to the variable $plan. The returned object lists each logical disk for that server, along with the server IDs to which the logical disks will be moved. No destination server was specified, so the software will select the most suitable destination server. Warnings are provided for seven logical disks, which will not be moved (unless actions are taken to remove the warnings and a new plan is generated). In this case there are four logical disks which have no warnings and will be moved in the event that the variable $plan is passed to the cmdlet Start-DcsDistributionPlan.

LogicalDiskId                                            Servers                                                                                                 Warnings
-------------                                            -------                                                                                                 --------
8c7cfd0d-6885-4575-9088-fd79b14197c4                     {606E5C02-8C8A-4562-8AB0-2D4FC5A90B81}                                                                      None
07a40cd1-be73-470d-96ed-a5e2d5e1bf69                     {606E5C02-8C8A-4562-8AB0-2D4FC5A90B81}                                                                      None
18038c60-9243-4d8a-9c92-3551c9a8b28a                     {606E5C02-8C8A-4562-8AB0-2D4FC5A90B81}                                                                      None
2a5de906-f3bc-4592-9f6f-e18b8dbd64a0                     {606E5C02-8C8A-4562-8AB0-2D4FC5A90B81}                                                                      None
acb5b7e5-c3f7-404a-88ee-d605e204f847                     {C8A77BC1-E998-4B73-90BF-DE7F097861C2}                                                IsSequentialStorageEnabled
1e9e5134-d88d-42c5-ad07-dfb9b1e7531d                     {606E5C02-8C8A-4562-8AB0-2D4FC5A90B81}                                                          IsRollbackSource
c141d228-9457-47b4-9801-2ecd491d5cf6                                                                                                         IsDataProtected, IsNotShared
7e988623-4833-42c0-8076-05e47f68363c                                                                                                                          IsNotShared
5a634ef3-b61b-4831-b0bc-2347b5dc9e63                                                                                                                          IsNotShared
798d7069-2c36-4ee8-9bd6-612d0567cac0                                                                                                                        IsNonMirrored
71b962e8-d009-4f0b-b2b1-3b8b4562b767                                                                              ... IsRollbackDestination, IsDataProtected, IsNotShared
0608e471-0c63-49d2-9b4c-a9ff8c3d0893                                                                                                                          IsNotShared
cebda920-8a8b-45fa-bbaf-cc42ac0bced1                                                                                                                          IsNotShared

-------------- Example 2 Returns the distribution plan for a specified server and destination server to redistribute virtual disks and pipe the output directly to StartDcsDistributionPlan. --------------
Get-DcsLogicalDisk -Server SSV1 | Get-DcsDistributionPlan -DestinationServer SSV2 | Start-DcsDistributionPlan

This example creates a distribution plan for a "Redistribute to DataCore Server" operation. The cmdlet Get-DcsLogicalDisk is invoked to obtain all LogicalDiskData objects for the server named "SSV1". Those objects are piped to the cmdlet Get-DcsDistributionPlan to generate the distribution plan for the server "SSV1". The server named "SSV2" is specified as the destination server, where all eligible storage sources will be moved. The returned LogicalDiskDistributionSet object is piped directly to the cmdlet Start-DcsDistributionPlan and all logical disks with no warnings are moved to the server "SSV2". All logical disks with warnings are not moved.