Move-ClusterGroup
Move-ClusterGroup
Moves a clustered role (a resource group) from one node to another in a failover cluster.
Sintaxis
Parameter Set: InputObject
Move-ClusterGroup [[-Name] <String> ] [[-Node] <String> ] [-Cluster <String> ] [-IgnoreLocked] [-InputObject <PSObject> ] [-Wait <Int32> ] [ <CommonParameters>]
Descripción detallada
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.
Parámetros
-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 |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-IgnoreLocked
Specifies that locked groups are ignored when running the cmdlet.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InputObject<PSObject>
Specifies the resource group to move.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
true (ByValue) |
¿Aceptar caracteres comodín? |
false |
-Name<String>
Specifies the name of the resource group to move.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
1 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Node<String>
Specifies the name of the cluster node to which to move the resource group.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
2 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
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 |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
- Microsoft.FailoverClusters.PowerShell.ClusterGroup
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
- Microsoft.FailoverClusters.PowerShell.ClusterGroup
Ejemplos
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