Edit

Share via

Remove-CauClusterRole

  • Reference
Module:
ClusterAwareUpdating

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

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 isn't 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
Required:False
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
Required: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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet isn't run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

None