NAME

Repair-DcsVirtualDisk

SYNOPSIS

Replaces one failed storage source (logical disk) in a mirrored virtual disk with another storage source from a healthy disk pool.

SYNTAX

Repair-DcsVirtualDisk   -TriggerState <Object>   -DiskPools <String[]>   [ -LocalServerOnly]   [ -ForceSplit]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Repair-DcsVirtualDisk   -VirtualDisk <Object>   -DiskPools <String[]>   [ -LocalServerOnly]   [ -ForceSplit]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Repair-DcsVirtualDisk   -LogicalDisk <Object>   -DiskPools <String[]>   [ -LocalServerOnly]   [ -ForceSplit]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Replaces one failed storage source (logical disk) in a virtual disk with another storage source from a healthy disk pool. The logical disk to replace can be identified by virtual disk or logical disk if run from the cmdlet. If the virtual disk is healthy and does not require fixing, an informational message to that effect will be logged and the repair will not take place. If the virtual disk is failed but cannot be repaired (for instance, in double failure), an alert will be posted with an explanation.

PARAMETERS

-TriggerState<Object>

The TriggerState will be appended to the script when a task trigger fires and a PowerShell script action is configured with the AppendTriggerStates parameterPowerShell script action in the task. (See Add-DcsAction for more information.) THIS PARAMETER IS ONLY VALID WHEN RUNNING A SCRIPT ACTION IN A TASK. THE ONLY WAY TO USE THE TRIGGER STATE IS FROM THE TASK. It cannot be used by invoking this cmdlet.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-DiskPools<String[]>

A comma separated list of pool candidates to use as the new logical disk for a failed virtual disk. The pool will be automatically selected from the list. Eligible candidates will be online and healthy, and cannot exist on the same server as the healthy storage source side of the mirror. The list can include pools from different servers, but a pool on the same server as the failed storage source will be preferred in order to maintain the same front-end paths and avoid a rescan on the host. The first eligible pool in the list of pool candidates will be used. All pool names should be unique to the server group. For example, if the list consisted of "Disk pool 1", "Disk pool 2", "Disk pool 3" and all three pools are eligible candidates and "Disk pool 1" resides on the same server as the failed storage source, "Disk pool 1" will be selected. NOTE: To include shared disk pools in the list, use the extended caption for the pool in order to identify which server to use to create the logical disk and corresponding paths. For instance "SharedPool1 on Server1".

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-LocalServerOnly<SwitchParameter>

A switch parameter that indicates to only use disk pools from the same server that has the failed storage source. This will prevent the host paths from being replaced which would force the client (host) to perform a disk rescan to see the new paths. This cmdlet will always prefer to repair a virtual disk using local resources, but without this parameter, the cmdlet will split and remirror a virtual disk to repair it if local resources are not available.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-ForceSplit<SwitchParameter>

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

-VirtualDisk<Object>

The VirtualDiskData object, ID, or name that identifies a virtual disk. To get the virtual disk object or ID, see Get-DcsVirtualDisk.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-LogicalDisk<Object>

The LogicalDiskData object, ID, or name that identifies a logical disk. To get the logical disk object or ID, see Get-DcsLogicalDisk.

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

Also see Replace-DcsVirtualDisk, Move-DcsVirtualDiskSource, Get-DcsVirtualDisk, Get-DcsLogicalDisk

EXAMPLES

Get-DcsVirtualDisk -ServerGroup Group1 | Repair-DcsVirtualDisk -DiskPools "Disk pool 1", "Disk pool 2", "Disk pool 3", "Disk pool 4", "Disk pool 5" -LocalServerOnly
		

$LD = Get-DcsLogicalDisk -VirtualDisk "Virtual disk 3" -Server SSV1
Repair-DcsVirtualDisk -LogicalDisk $LD -DiskPools SSV3Pool1