NAME

Move-DcsLogicalDisk

SYNOPSIS

Moves a logical disk (storage source) used in a mirrored or dual virtual disk.

SYNTAX

Move-DcsLogicalDisk   -VirtualDisk <Object>   -Pool <Object>   [ -Server <Object> ]   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Move-DcsLogicalDisk   -VirtualDisk <Object>   -SourceServer <Object>   -DestinationServer <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Move-DcsLogicalDisk   -LogicalDisk <Object>   -Pool <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Move-DcsLogicalDisk   -LogicalDisk <Object>   -DestinationServer <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Moves a logical disk (storage source) used in a mirrored or dual virtual disk. The logical disk in a mirrored virtual disk can be moved to another disk pool on the same server. The logical disk in a dual virtual disk can be moved to another server that shares the pool. Paths are adjusted to use the new source. The move is done with a minimal loss of high availability.

PARAMETERS

-VirtualDisk<Object>

VirtualDiskData object, name or ID that identifies the virtual disk with the storage source to move. (The VirtualDiskData object can be obtained from Get-DcsVirtualDisk.)

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Pool<Object>

DiskPoolData object, name or ID that identifies the disk pool to use to create the new storage source. To resolve by name, the name must be unique to the server group or the server must be specified. (The DiskPoolData object can be obtained from Get-DcsPool.)

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Server<Object>

ServerHostData object, name or ID that identifies the server that owns the logical disk to be moved. The computer name must be unique or the name must be fully qualified. (The ServerHostData object can be obtained from Get-DcsServer.)

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Yes<SwitchParameter>

Moving a logical disk is an operation that requires confirmation. Specify this parameter to confirm your intention in order to prevent user interaction during scripted scenarios. If this parameter is not specified, user interaction will be required.

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

-WhatIf<SwitchParameter>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Confirm<SwitchParameter>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-SourceServer<Object>

ServerHostData object, name or ID that identifies the server that owns the current logical disk to be moved in a shared pool. Use this parameter when moving the storage source from one server to another server that share the same disk pool. The computer name must be unique or the name must be fully qualified. (The ServerHostData object can be obtained from Get-DcsServer.)

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-DestinationServer<Object>

ServerHostData object, name or ID that identifies the new server where the storage source is to be moved within a shared pool. Use this parameter when moving the storage source from one server to another server that share the same disk pool. The computer name must be unique or the name must be fully qualified. (The ServerHostData object can be obtained from Get-DcsServer.)

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LogicalDisk<Object>

LogicalDiskData object, ID or caption of a logical disk that identifies the storage source to move.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

INPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

OUTPUTS

VirtualDiskData : Object that identifies and describes the virtual disk.

NOTES

Only logical disks that are eligible to be moved will be moved. Warnings will be provided for logical disks that cannot be moved. Also see Stop-DcsMoveStorageSource, Get-DcsVirtualDisk, Replace-DcsVirtualDiskSource

EXAMPLES

$SSV1_VDs = Get-DcsVirtualDisk -Server "SSV1"
$SSV1_VDs | ForEach { Move-DcsLogicalDisk -Server "SSV1" -VirtualDisk $_.Id -Pool "Disk pool 4" }
		

Move-DcsLogicalDisk -VirtualDisk "Virtual disk 5" -SourceServer "SSV1" -DestinationServer "SSV3" -Yes
		

$LD = Get-DcsLogicalDisk -Server "SSV1" -Pool "Disk pool 4"
ForEach ($l in $LD) {Move-DcsLogicalDisk -LogicalDisk $l.Id -Pool "Disk pool 1"}
		

$LD = Get-DcsLogicalDisk -Server "SSV1" -Pool "Shared pool 1"
ForEach ($l in $LD) {Move-DcsLogicalDisk -LogicalDisk $l.Id -DestinationServer "SSV2"}