Remove-Cluster

Remove-Cluster

Destroys an existing failover cluster.

Syntaxe

Parameter Set: InputObject
Remove-Cluster [[-Cluster] <String> ] [-CleanupAD] [-Force] [-InputObject <PSObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Remove-Cluster cmdlet destroys an existing failover cluster. The affected servers will no longer function together as a cluster.

This cmdlet deletes all copies of the cluster configuration database on all cluster nodes.

Paramètres

-CleanupAD

Specifies that when the cluster is destroyed, the objects in Active Directory that are associated with the cluster are removed.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Cluster<String>

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Alias

none

Requis ?

false

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Force

Runs the cmdlet without prompting for confirmation. By default the cmdlet will ask for confirmation from the user before proceeding.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InputObject<PSObject>

Specifies the cluster to destroy.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-Confirm

Vous invite à confirmer l'exécution de l'applet de commande.

Requis ?

false

Position ?

named

Valeur par défaut

false

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Indique ce qui se produit en cas d'exécution de l'applet de commande. L'applet de commande n'est pas exécutée.

Requis ?

false

Position ?

named

Valeur par défaut

false

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

  • Microsoft.FailoverClusters.PowerShell.Cluster

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

  • None

Exemples

Example 1

This example prompts the user for confirmation, then destroys the local failover cluster and removes cluster configuration information from the cluster nodes.

PS C:\> Remove-Cluster

Example 2

This example destroys the local failover cluster and removes cluster configuration information from the cluster nodes. The cmdlet does not prompt for confirmation.

PS C:\> Remove-Cluster -Force

Example 3

This example destroys the cluster named Cluster1, removes cluster configuration information from the cluster nodes, and deletes the cluster objects in Active Directory. The cmdlet does not prompt for confirmation.

PS C:\> Get-Cluster –Name Cluster1 | Remove-Cluster -Force -CleanupAD

Rubriques connexes

Get-Cluster

New-Cluster

Start-Cluster

Stop-Cluster

Test-Cluster