NAME

Set-DcsServerGroupDefaultWitnessProperties

SYNOPSIS

Sets the default witness properties for the server group.

SYNTAX

Set-DcsServerGroupDefaultWitnessProperties   -Address <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsServerGroupDefaultWitnessProperties   -IOFenced   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Set-DcsServerGroupDefaultWitnessProperties   -NoWitness   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets the default witness properties for the server group. The default server group setting is applied to all virtual disks that are not individually configured to use a specific witness with the cmdlet Set-DcsVirtualDiskWitnessProperties. The witness can be configured by providing an IP address for that witness. If the witness already exists and an IP address is provided, the IP address for the witness is changed. If a witness does not exist, it is created automatically using the provided IP address and assigned a default name. If there is an existing witness and it is set as either the -IOFenced or -NoWitness option, the witness is no longer needed and automatically deleted.

PARAMETERS

-Address<String>

IP address of the witness. This parameter will either change the IP address of an existing witness, or create a new witness with the provided IP address if a witness does not already exist. New witness is created with the base name of "Witness" with a number appended, such as Witness 1, Witness 2.

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 in applicable virtual disks.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-NoWitness<SwitchParameter>

Specify this parameter to disable the witness and remove it from the server group configuration. This option does not disable host access in any way. Data will continue to flow through enabled front-end paths.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

INPUTS

OUTPUTS

ServerHostGroupData : Object that identifies and describes the server group.

NOTES

The current values for DefaultWitness (Witness ID), and DefaultWitnessOption are displayed in the returned object from Get-DcsServerGroup. Related cmdlets: Add-DcsWitness, Get-DcsWitness, Remove-DcsWitness, Set-DcsVirtualDiskWitnessProperties, Set-DcsWitnessProperties, Invoke-DcsWitnessContact.

EXAMPLES

Set-DcsServerGroupDefaultWitnessProperties -Address "172.99.99.999"
		

Set-DcsServerGroupDefaultWitnessProperties -IOFenced