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 |