Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Remove-CauClusterRole

Last Updated: 3/26/2017

SYNOPSIS

Removes the CAU clustered role from the specified failover cluster.

SYNTAX

Remove-CauClusterRole [[-ClusterName] <String>] [[-Credential] <PSCredential>] [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

The Remove-CauClusterRole cmdlet removes the Cluster-Aware Updating (CAU) clustered role from the specified failover cluster. To run CAU from a cluster, ensure that the CAU clustered role is configured in that cluster.

The Remove-CauClusterRole cmdlet removes the virtual computer object (VCO) in Active Directory for the CAU clustered role, unless you previously prestaged or specified the VCO by using the Add-CauClusterRole cmdlet with the VirtualComputerObjectName parameter.

EXAMPLES

Example 1: Remove an instance of a CAU clustered role configured on the specified cluster

PS C:\> Remove-CauClusterRole -ClusterName "CONTOSO-FC1" -Force

This command removes the instance of the CAU clustered role that is configured on the cluster named CONTOSO-FC1. Because the command specifies the Force parameter, the cmdlet runs without displaying confirmation prompts.

PARAMETERS

-ClusterName

Specifies the name of the cluster from which to remove the CAU clustered role. This parameter is only required when this cmdlet is not run on a failover cluster node, or this cmdlet is used to reference a failover cluster different from where the cmdlet is run.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Specifies the administrative credentials for the target cluster.

Type: PSCredential
Parameter Sets: (All)
Aliases: 

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Force

Forces the command to run without asking for user confirmation.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: f

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

None

NOTES

Add-CauClusterRole

Disable-CauClusterRole

Enable-CauClusterRole

Get-CauClusterRole

Set-CauClusterRole

© 2017 Microsoft