Remove-Cau Cluster Role

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.

Optional 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
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Credential

Specifies the administrative credentials for the target cluster.

Type: PSCredential
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
Aliases: f
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
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Inputs

None

Outputs

None