NAME

Disable-DcsVirtualDiskAutoRecovery

SYNOPSIS

Disables automatic mirror recovery for a virtual disk or virtual disk group.

SYNTAX

Disable-DcsVirtualDiskAutoRecovery   -VirtualDisk <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Disable-DcsVirtualDiskAutoRecovery   -VirtualDiskGroup <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Disables automatic mirror recovery for a virtual disk or virtual disk group. After disabling auto-recovery, mirror recovery must be manually started, see Resume-DcsVirtualDiskRecovery.

PARAMETERS

-VirtualDisk<Object>
VirtualDiskData object, name, or ID that identifies the virtual disk.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
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

-VirtualDiskGroup<Object>
VirtualDiskGroupData object, name or ID that identifies a virtual disk group. When the operation is performed on a virtual disk group, auto-recovery will be disabled for all eligible virtual disks in the group and the rest will be ignored.

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 Enable-DcsVirtualDiskAutoRecovery, Get-DcsVirtualDisk, Get-DcsVirtualDiskGroup, Resume-DcsVirtualDiskRecovery, Pause-DcsVirtualDiskRecovery.

EXAMPLES


-------------- Example 1 Disables auto recovery for all virtual disks on a specified server --------------
Get-DcsVirtualDisk -Server SSV1 | Disable-DcsVirtualDiskAutoRecovery

The cmdlet Get-DcsVirtualDisk is invoked to get VirtualDiskData objects for all virtual disks on the server named "SSV1." The results are piped to the cmdlet Disable-DcsVirtualDiskAutoRecovery to disable auto-recovery for all eligible virtual disks. A VirtualDiskData object is returned for each virtual disk that has been disabled.

VirtualDiskGroupId:
FirstHostId:E9D5564F-D72A-4C5C-AA0F-B2C23A3AD093
SecondHostId:BBA07A42-44F1-40A6-A0E0-756351FFE386
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 1
Description:
Size:50.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS ec6a87754077499dbe1eda213c6df2e0
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D90446DFE01504F9B5BE7187E6F
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:True
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:True
Sequencenumber:35198
Id:ec6a87754077499dbe1eda213c6df2e0
Caption:Virtual disk 1
ExtendedCaption:Virtual disk 1 from Group1
Internal:False
   
VirtualDiskGroupId:
FirstHostId:E9D5564F-D72A-4C5C-AA0F-B2C23A3AD093
SecondHostId:BBA07A42-44F1-40A6-A0E0-756351FFE386
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 4
Description:
Size:45.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS c342896abdbb4de9ba009e9ee63fa815
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D903E7D6C078ED2765BEE1ADBCA
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:True
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:True
Sequencenumber:35200
Id:c342896abdbb4de9ba009e9ee63fa815
Caption:Virtual disk 4
ExtendedCaption:Virtual disk 4 from Group1
Internal:False
   
VirtualDiskGroupId:
FirstHostId:E9D5564F-D72A-4C5C-AA0F-B2C23A3AD093
SecondHostId:BBA07A42-44F1-40A6-A0E0-756351FFE386
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 6
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS 26599ea3d8704c668b0c6ee048c00653
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D90E6876C07DBC76ADE1851A94A
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:True
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:True
Sequencenumber:35202
Id:26599ea3d8704c668b0c6ee048c00653
Caption:Virtual disk 6
ExtendedCaption:Virtual disk 6 from Group1
Internal:False
   
VirtualDiskGroupId:{94add581-0054-4317-95c7-f6f81309370b}
FirstHostId:E9D5564F-D72A-4C5C-AA0F-B2C23A3AD093
SecondHostId:BBA07A42-44F1-40A6-A0E0-756351FFE386
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 2
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS a55059113f1e424895f4eea7751aa546
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D906348F000688BBA02259ABAE1
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:True
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Sequencenumber:35205
Id:a55059113f1e424895f4eea7751aa546
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 from Group1
Internal:False
   

-------------- Example 2 Disables auto recovery for all virtual disk groups --------------
Disable-DcsVirtualDiskAutoRecovery -VirtualDiskGroup VDGroup1

The cmdlet Get-DcsVirtualDiskGroup is invoked to get all VirtualDiskGroupData objects for the local server group. Those objects are used as the values for the parameter VirtualDiskGroup. Auto-recovery is disabled for all eligible virtual disks in all virtual disk groups in the local server group. A VirtualDiskData object is returned for each virtual disk that has been disabled.

VirtualDiskGroupId:{94add581-0054-4317-95c7-f6f81309370b}
FirstHostId:E9D5564F-D72A-4C5C-AA0F-B2C23A3AD093
SecondHostId:BBA07A42-44F1-40A6-A0E0-756351FFE386
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
SnapshotPoolId:
Alias:Virtual disk 2
Description:
Size:10.00 GiB
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS a55059113f1e424895f4eea7751aa546
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D906348F000688BBA02259ABAE1
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:True
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
IsServed:False
Sequencenumber:35329
Id:a55059113f1e424895f4eea7751aa546
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 from Group1
Internal:False