Move-ClusterGroup
Move-ClusterGroup
Moves a clustered role (a resource group) from one node to another in a failover cluster.
Syntaxe
Parameter Set: InputObject
Move-ClusterGroup [[-Name] <String> ] [[-Node] <String> ] [-Cluster <String> ] [-IgnoreLocked] [-InputObject <PSObject> ] [-Wait <Int32> ] [ <CommonParameters>]
Description détaillée
The Move-ClusterGroup cmdlet moves a clustered role (a resource group) from one node to another in a failover cluster.
Moving a resource group is a way of simulating failover. Running this cmdlet is also an appropriate step to take in preparation for routine maintenance on a node.
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 |
-IgnoreLocked
Specifies that locked groups are ignored when running the cmdlet.
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 resource group to move.
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<String>
Specifies the name of the resource group to move.
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 |
-Node<String>
Specifies the name of the cluster node to which to move the resource group.
Alias |
none |
Requis ? |
false |
Position ? |
2 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Wait<Int32>
Specifies the time in seconds to wait for the cmdlet. If the Wait parameter is not specified, then the cmdlet waits for completion. If -Wait 0
is specified, then the call is initiated and the cmdlet returns without waiting.
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 |
<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.
- Microsoft.FailoverClusters.PowerShell.ClusterGroup
Exemples
EXAMPLE 1
This example moves the clustered service called MyFileServer from the current owner node to any other node.
PS C:\> Move-ClusterGroup –Name MyFileServer
EXAMPLE 2
This example moves the resource group called MyFileServer from the current owner node to the node named node2.
PS C:\> Move-ClusterGroup –Name MyFileServer -Node node2
EXAMPLE 3
This example moves all resource groups that are currently owned by the node named node3 to other nodes. Use this cmdlet before performing maintenance on the specified node.
PS C:\> Get-ClusterNode node3 | Get-ClusterGroup | Move-ClusterGroup
EXAMPLE 4
This example moves the resource group called MyFileServer from the current owner node to the node named node2
. Information about MyFileServer is displayed immediately, while it is in the process of being moved.
PS C:\> Move-ClusterGroup –Name MyFileServer -Node node2 -Wait 0