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
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.
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.
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.