Move-ClusterSharedVolume

  • Reference
Module:
FailoverClusters

Moves a Cluster Shared Volume (CSV) to ownership by a different node in a failover cluster.

Syntax

Move-ClusterSharedVolume
    [[-Name] <String>]
    [[-Node] <String>]
    [-Wait <Int32>]
    [-InputObject <PSObject>]
    [-Cluster <String>]
    [<CommonParameters>]

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:0
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:1
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