Move-ClusterSharedVolume
Move-ClusterSharedVolume
Move a Cluster Shared Volume to ownership by a different node in a failover cluster.
Syntax
Move-ClusterSharedVolume [-InputObject <psobject>] [[-Name] <string>] [[-Node] <string>] [-Cluster <string>] [-Wait <int>] [<CommonParameters>]
InputObject
Name
Node
Cluster
Wait
Detailed Description
On a failover cluster that uses Cluster Shared Volumes, at any given time, access to each Cluster Shared Volume is controlled by a particular node, called the "owner" of that Cluster Shared Volume. However, a single Cluster Shared Volume can contain VHD files used by multiple clustered virtual machines that are distributed across multiple cluster nodes.
Parameters
Cluster
Specifies the name of the cluster to run this cmdlet on. If you type "-Cluster ." or omit the parameter, the cmdlet runs on the local cluster.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
InputObject
Specifies the cluster shared volume to move.
Default Value: **
Data Type: psobject
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
true (ByValue) |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Name
Specifies the name of the cluster shared volume to move.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
1 |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Node
Specifies the name of the cluster node to move the cluster shared volume to.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
2 |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Wait
Specifies the time in seconds to wait for the operation. If this parameter is not specified the operation waits for completion. If "-Wait 0" is specified the call is initiated and the cmdlet returns right away.
Default Value: **
Data Type: int
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Input Type
Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume
Return Type
Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume
Examples
-------------------------- EXAMPLE 1 --------------------------
Command Prompt: C:\PS>
Move-ClusterSharedVolume "Cluster Disk 3"
Name State Node
---- ----- ----
Cluster Disk 3 Online node2
Description
-----------
This command moves the Cluster Shared Volume called Cluster Disk 3 to any other cluster node.
-------------------------- EXAMPLE 2 --------------------------
Command Prompt: C:\PS>
Move-ClusterSharedVolume "Cluster Disk 3" -Node node1
Name State Node
---- ----- ----
Cluster Disk 3 Online node1
Description
-----------
This command moves the Cluster Shared Volume called Cluster Disk 3 to node1.
See Also
Reference
Add-ClusterSharedVolume
Get-ClusterSharedVolume
Remove-ClusterSharedVolume
Repair-ClusterSharedVolume
Resume-ClusterResource
Start-ClusterResource
Stop-ClusterResource
Suspend-ClusterResource