Move-HardDisk

Syntax

• UpdateHardDisk

Move-HardDisk

[-Datastore]  <StorageResource>
-HardDisk  <HardDisk[]>
[-RunAsync]
[-Server  <VIServer[]>]
[-StorageFormat  <VirtualDiskStorageFormat>]
[CommonParameters]

---

Parameters

Required	Parameter Name	Type	Position	Features	Description
required	Datastore	StorageResource	1		Specifies a datastore or ? datastore cluster to move ? hard disk to. If a datastore cluster is specified, the system checks whether the Storage Distributed Resource Scheduler (SDRS) is enabled and acts accordingly. If SDRS is enabled, the system allocates the hard disk to the datastore cluster in automated SDRS mode. If SDRS is deactivated, the system allocates the hard disk to the datastore with the largest amount of free space in the datastore cluster.
required	HardDisk	HardDisk[]	named	pipeline	Specifies the hard disk that you want to move to another location.
optional	RunAsync	SwitchParameter	named		Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console.
optional	Server	VIServer[]	named		Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.
optional	StorageFormat	VirtualDiskStorageFormat	named		Specifies the storage format of the relocated hard disk. This parameter accepts Thin, Thick, and EagerZeroedThick values.

Output

VMware.VimAutomation.ViCore.Types.V1.VirtualDevice.HardDisk

Examples

---

Example 1

$myDatastore1 = Get-Datastore -Name 'MyDatastore1'

$myDisk = Get-VM -Name MyVm1 | Get-HardDisk

Move-HardDisk -HardDisk $myDisk -Datastore $myDatastore1

Moves the hard disk of a specified virtual machine to another datastore.

Example 2

$myDisk = Get-VM -Name 'MyVM1' | Get-HardDisk

$myDatastore1 = Get-Datastore -Name 'MyDatastore1'

Move-HardDisk -HardDisk $myDisk -Datastore $myDatastore1 -StorageFormat 'EagerZeroedThick'

Moves the hard disk of a specified virtual machine to another datastore and changes the storage format of the hard disk to EagerZeroedThick.

Example 3

$myDisk = Get-VM -Name 'MyVM1' | Get-HardDisk

$myDatastoreCluster = Get-DatastoreCluster -Name 'MyDatastoreCluster'

Move-HardDisk -HardDisk $myDisk -Datastore $myDatastoreCluster

Moves the hard disk of the 'MyVM1' virtual machine to the 'MyDatastoreCluster' datastore cluster.

Related Commands