NAME
Remove-DcsServer
SYNOPSIS
Removes the specified server from the server group.
SYNTAX
Remove-DcsServer -Server <Object> [ -Yes] [ -Connection <String> ] [ -PipelineVariable <String> ] [ -WhatIf] [ -Confirm]
DESCRIPTION
Removes the specified server from the server group. The server to be removed will exist in its own group.
PARAMETERS
- -Server<Object>
- ServerHostData object, computer name, or ID that identifies the server to be removed. The computer name must be unique or the name must be fully qualified.
-
- Required: true
- Position: 1
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Yes<SwitchParameter>
- Removing a server from a server group is an operation that requires confirmation. Specify this parameter to confirm your intention to remove the server and prevent user interaction during scripted scenarios. If this parameter is not specified, user interaction will be required.
-
- Required: false
- 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
-
- -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
-
INPUTS
ServerHostData : Object that identifies and describes the server.
OUTPUTS
NOTES
Also see Add-DcsServer.
EXAMPLES
-------------- Example 1 Removes a server by name --------------
Remove-DcsServer -Server SSV2 -Yes
The server named SSV2 is removed from the server group of the default connection. The Yes parameter was included to eliminate the need to confirm the operation.