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
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 |
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 |