Move-ClusterSharedVolume
Moves a Cluster Shared Volume (CSV) to ownership by a different node in a failover cluster.
Syntax
Move-ClusterSharedVolume
[[-Name] <String>]
[[-Node] <String>]
[-Cluster <String>]
[-InputObject <PSObject>]
[-Wait <Int32>]
Description
The Move-ClusterSharedVolume cmdlet moves a Cluster Shared Volume (CSV) to ownership by a different node in a failover cluster.
On a failover cluster that uses CSVs, at any given time, access to each CSV is controlled by a particular node, called the owner of that CSV. However, a single CSV can contain virtual hard disk (VHD) files used by multiple clustered virtual machines that are distributed across multiple cluster nodes.
Examples
Example 1
PS C:\>Move-ClusterSharedVolume -Name "Cluster Disk 3"
Name State Node
---- ----- ----
Cluster Disk 3 Online node2
This example moves the Cluster Shared Volume called Cluster Disk 3 to another cluster node.
Example 2
PS C:\>Move-ClusterSharedVolume -Name "Cluster Disk 3" -Node node1
Name State Node
---- ----- ----
Cluster Disk 3 Online node1
This example moves the Cluster Shared Volume called Cluster Disk 3 to the node named node1.
Parameters
-Cluster
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifies the Cluster Shared Volume to move.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifies the name of the Cluster Shared Volume to move.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Node
Specifies the name of the cluster node to which to move the Cluster Shared Volume.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume
Outputs
Microsoft.FailoverClusters.PowerShell.ClusterSharedVolume