NAME

Start-DcsDistributionPlan

SYNOPSIS

Moves eligible logical disks (storage sources) from a specified server to one or more servers in the server group.

SYNTAX

Start-DcsDistributionPlan   -DistributionPlan <LogicalDiskDistributionSet[]>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Start-DcsDistributionPlan   -SourceServer <Object>   -DestinationServer <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Moves eligible logical disks (storage sources) from a specified server to other servers in the server group. Logical disks can be moved using two different methods. Method 1- All eligible logical disks from one server (source server) are moved to another server (destination server). A distribution plan is not needed. This method behaves in the same way as the "Evacuate DataCore Server" operation. Method 2 - All eligible logical disks are moved to one or more servers based on the distribution plan (see Get-DcsDistributionPlan). In this method, the operation is performed based on the distribution plan and behaves in the same way as the "Evacuate DataCore Server" or "Redistribute to DataCore Server" operations. The Get-DcsDistributionPlan can be rerun before invoking this cmdlet in the event that actions have been taken to reduce warnings which cause the plan to change.

PARAMETERS

-DistributionPlan<LogicalDiskDistributionSet[]>
An array of LogicalDiskDistributionSet, which is the distribution plan created from the cmdlet Get-DcsDistributionPlan.

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

-Yes<SwitchParameter>
Logical disks with warnings will not be moved unless the Yes parameter is used. Specify this parameter to confirm your intention to move logical disks that have warnings. This parameter prevents user interaction and is required for scripted scenarios.

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

-SourceServer<Object>
ServerHostData object, computer name or ID that identifies the server with the virtual disks to evacuate. The computer name must be unique or the name must be fully qualified. The ServerHostData object can be obtained using Get-DcsServer.

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

-DestinationServer<Object>
ServerHostData object, computer name or ID that identifies the server that will receive the virtual disks that are evacuated. The computer name must be unique or the name must be fully qualified. The ServerHost object can be obtained using Get-DcsServer.

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

INPUTS

LogicalDiskDistributionSet[] : An array of LogiicalDiskDistributionSet, which is the distribution plan created from the cmdlet Get-DcsDistributionPlan.

OUTPUTS

NOTES

Eligible logical disks can be from single, dual, or mirrored virtual disks. Hosts will temporarily lose access to single virtual disks during the operation. This operation can also move logical disks from servers that are unavailable (offline or failed), although in this case moving logical disks from multipath mirrored virtual disks that are not in write-through modes will fail. Logical disks with warnings will not be moved unless the Yes parameter is used. Also see related cmdlet Get-DcsDistributionPlan.

EXAMPLES


-------------- Example 1 Starts the distribution of storage sources from a specified server to other eligible servers using the distribution plan --------------
Get-DcsLogicalDisk -Server SSV1 | Get-DcsDistributionPlan | Start-DcsDistributionPlan
		

This cmdlet starts an operation that behaves in the same way as the "Evacuate DataCore Server" operation. The cmdlet Get-DcsLogicalDisk is invoked to get all the LogicalDiskData objects for the server "SSV1". The results are piped to the cmdlet Get-DcsDistributionPlan to create the distribution plan and the plan is piped to the cmdlet Start-DcsDistributionPlan to start the operation.


-------------- Example 2 Starts the distribution of storage sources from a specified server to another specified server using the distribution plan --------------
Get-DcsLogicalDisk -Server "SSV2" | Get-DcsDistributionPlan -DestinationServer "SSV1"  | Start-DcsDistributionPlan
		

This cmdlet starts an operation that behaves in the same way as the "Redistribute to DataCore Server" operation. The cmdlet Get-DcsLogicalDisk is invoked to get all the LogicalDiskData objects for the server "SSV2". The results are piped to the cmdlet Get-DcsDistributionPlan and the parameter DestinationServer is used to specify that the storage sources should be moved to the server "SSV1" and a distribution plan is created. The plan is piped to the cmdlet Start-DcsDistributionPlan to start the operation.


-------------- Example 3 Starts the distribution of storage sources from a source server to the destination server --------------
Start-DcsDistributionPlan -SourceServer "SSVVM01" -DestinationServer "SSVVM06" -Yes
		

Storage sources from the source server named "SSVVM01" are moved to the destination server named "SSVVM06". A distribution plan is not needed when source server and destination server are supplied to the cmdlet. The parameter Yes is included in order to also move storage sources with warnings.