Remove-ClusterGroup
Remove-ClusterGroup
Removes a clustered role, also called a resource group, from a failover cluster.
Syntaxe
Parameter Set: InputObject
Remove-ClusterGroup [[-Name] <StringCollection> ] [-Cluster <String> ] [-Force] [-InputObject <PSObject> ] [-RemoveResources] [-VMId <System.Guid> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Description détaillée
The Remove-ClusterGroup cmdlet removes a clustered role. also called a resource group, from a failover cluster.
Use this cmdlet to delete a group. If the group still has resources in it, then either remove the resources first, or specify the RemoveResources parameter.
Paramètres
-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 ? |
named |
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 clustered role to remove.
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 |
-Name<StringCollection>
Specifies the name of the clustered role to remove.
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 |
-RemoveResources
Causes the cmdlet to delete all resources in the clustered role before removing the clustered role.
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 |
-VMId<System.Guid>
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
true(ByPropertyName) |
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.ClusterGroup
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 and then removes the clustered role named MyFileServer, if the resources have first been removed from it.
PS C:\> Remove-ClusterGroup –Name MyFileServer
EXAMPLE 2
This example removes the clustered role named MyFileServer, if the resources have first been removed from it. The cmdlet does not prompt for confirmation.
PS C:\> Remove-ClusterGroup –Name MyFileServer -Force
EXAMPLE 3
This example removes the clustered role named MyFileServer, without prompting for confirmation. All cluster resources in MyFileServer will be deleted.
PS C:\> Remove-ClusterGroup –Name MyFileServer -Force -RemoveResources