NAME

Split-DcsVirtualDisk

SYNOPSIS

Splits a multi-copy or dual virtual disk.

SYNTAX

Split-DcsVirtualDisk   -VirtualDisk <Object>   [ -UnserveServer <Object> ]   [ -Force]   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Splits a multi-copy or dual virtual disk. When splitting a multi-copy virtual disk that is unserved , each server with a copy of the data will retain that copy as a single virtual disk. A dual virtual disk will become one single virtual disk on one server. To split a virtual disk that is served, use the parameter UnserveServer. To split a dual virtual disk or to split one storage source from a 3-Way Virtual Disks specify the server by using the parameter UnserveServer. See UnserveServer for more information.

PARAMETERS

-VirtualDisk<Object>

VirtualDiskData object, name, or ID that identifies the virtual disk to split.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-UnserveServer<Object>

ServerHostData object or ID that identifies the server to unserve. Use this parameter to split without unserving a virtual disk or to split a dual virtual disk. If specified, all front-end paths from this server to a client host will be removed. In the case of a dual virtual disk, the specified server will be removed as a storage source of the virtual disk. In the case of a 3-Way Virtual Disks, the specified server will be split to create a single virtual disk, and a mirrored virtual disk is left from the remaining storage sources.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Force<SwitchParameter>

Use this parameter to force the operation to be performed in the case of 3-Way Virtual Disks, when one of the active storage sources is being split and the inactive storage source is failed or is determined to be not up-to-date by the software. For example, this could occur when the the virtual disk is failed or in recovery. Forcing this operation can cause a full recovery.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Yes<SwitchParameter>

Forcing the split operation when the state of the data on the inactive storage source is unknown or not up-to-date and the operation can result in full recovery requires confirmation. Specify this parameter to confirm your intention and prevent user interaction during 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 will be 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

INPUTS

VirtualDiskData : Object that identifies the virtual disk to be split.

OUTPUTS

VirtualDiskData : Object that identifies and describes the virtual disk created by the split operation.

NOTES

Also see Get-DcsVirtualDisk, Add-VirtualDiskMirror.

EXAMPLES

Split-DcsVirtualDisk -VirtualDisk "Virtual disk 1 from Local Group"
		

$SplitVD = Get-DcsVirtualDisk -ServerGroup "Local Group" -Kind Standard
$SplitVD | Split-DcsVirtualDisk
		

$Svr = Get-DcsServer -Server SSV2
Split-DcsVirtualDisk -VirtualDisk "Virtual disk 1" -UnserveServer $Svr
		

Split-DcsVirtualDisk -VirtualDisk "Virtual disk 2" -UnserveServer SSV1