NAME

Set-DcsVirtualDiskWitnessProperties

SYNOPSIS

Sets the witness properties for the specified virtual disk.

SYNTAX

Set-DcsVirtualDiskWitnessProperties   -VirtualDisk <Object>   -Witness <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsVirtualDiskWitnessProperties   -VirtualDisk <Object>   -IOFenced   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsVirtualDiskWitnessProperties   -VirtualDisk <Object>   -NoWitness   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets the witness properties for the specified virtual disk. Setting a witness or setting the Witness option to IOFenced will override the server group default witness setting for the specified virtual disk. When setting the witness to -IOFenced or -NoWitness, the witness is not automatically deleted from the configuration. (See Remove-DcsWitness in order to delete it.)

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

-Witness<String>
Name or ID that identifies the witness. The witness must exist in the server group configuration, see Add-DcsWitness if the witness does not exist in the configuration.

Required: true
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

-IOFenced<SwitchParameter>
Specify this parameter to set the witness option for an existing witness as "IOFenced", which will deny host access to both active storage sources for the specified virtual disk.

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-NoWitness<SwitchParameter>
Specify this parameter to set the witness option to Default, which will use whatever is configured for the server group default witness.

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

See Get-DcsVirtualDisk example to get current WitnessId and WitnessOption values set for all virtual disks. Related cmdlets: Set-DcsServerGroupDefaultWitnessProperties, Set-DcsWitnessProperties, Add-DcsWitness, Get-DcsWitness, Remove-DcsWitness.

EXAMPLES


-------------- Example 1 Sets a witness for the specified virtual disk. --------------
Set-DcsVirtualDiskWitnessProperties -Witness "Witness 2" -VirtualDisk "Virtual disk 2"
		

The witness for the virtual disk named "Virtual Disk 2" is set to the witness named "Witness 2".

VirtualDiskGroupId:
FirstHostId:79E57CB3-F7A6-48C1-B079-CAAEE2183ACE
SecondHostId:49949EE7-BF92-4833-A880-8BBCD096750B
BackupHostId:373B4037-4A93-4FD3-A7B4-C416DCCFD2CA
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
WitnessId:3a340e72221640879deba52582e23915
SnapshotPoolId:
Alias:Virtual disk 2
Description:
Size:10 GiB
SectorSize:512 B
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS 763a2c232bc841239b9e861a773fdd1a
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D9000A2D1006BA4D7600414C0E9
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
TPThresholdsEnabled:False
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
WitnessOption:Manual
Sequencenumber:2316074
Id:763a2c232bc841239b9e861a773fdd1a
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 from Local
Internal:False
   

-------------- Example 2 Sets the IOFenced witness option for the specified virtual disk. --------------
Set-DcsVirtualDiskWitnessProperties -VirtualDisk "Virtual disk 2" -IOFenced
		

The witness option for the virtual disk named "Virtual Disk 2" is set to "IOFenced", which disables all host access to the virtual disk.

VirtualDiskGroupId:
FirstHostId:49949EE7-BF92-4833-A880-8BBCD096750B
SecondHostId:79E57CB3-F7A6-48C1-B079-CAAEE2183ACE
BackupHostId:
StorageProfileId:100469DF-0BE1-40DA-874E-9F1DA5A259E3
WitnessId:
SnapshotPoolId:
Alias:Virtual disk 2
Description:
Size:20 GiB
SectorSize:512 B
Type:MultiPathMirrored
DiskStatus:Online
InquiryData:DataCore Virtual Disk DCS 42f697f2df404b029f77099cdba54e99
ScsiDeviceId:{96, 3, 13, 144...}
ScsiDeviceIdString:60030D90E8E606024A0C759D4736D4B1
RemovableMedia:False
WriteThrough:False
Offline:False
Disabled:False
ManualRecovery:False
DiskLayout:DataCore.Executive.PhysicalDiskLayout
PersistentReserveEnabled:True
RecoveryPriority:Regular
TPThresholdsEnabled:False
IsServed:False
SubType:Standard
MirrorTrunkMappingEnabled:False
WitnessOption:IoFenced
Sequencenumber:817549
Id:42f697f2df404b029f77099cdba54e99
Caption:Virtual disk 2
ExtendedCaption:Virtual disk 2 from Local
Internal:False