Copy-HardDisk
Copies a virtual hard disk to another destination specified by the DestinationPath parameter. DestinationPath must be a datastore path to the destination folder.
Syntax
[-HardDisk]
<HardDisk[]>
-DestinationPath <String>
[-DestinationStorageFormat <VirtualDiskStorageFormat>]
[-Force]
[-RunAsync]
[CommonParameters]
-DestinationPath <String>
[-DestinationStorageFormat <VirtualDiskStorageFormat>]
[-Force]
[-RunAsync]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
HardDisk[] | 1 |
|
Specifies the virtual hard disk you want to copy. | required |
|
String | named |
|
Specifies the datastore path to the folder where you want to copy the hard disk. The datastore name is included in the path in square braces. | optional |
|
VirtualDiskStorageFormat | named |
|
Specifies the type of the hard disk copy. The valid values are Thin, Thick, and EagerZeroedThick. This parameter is only applicable when you are connected to an ESX/ESXi host. | optional |
|
SwitchParameter | named |
|
Indicates whether to overwrite all disks with the same name at the provided destination. | optional |
|
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. |
Output
VMware.VimAutomation.ViCore.Types.V1.VirtualDevice.HardDisk
Examples
Example 1
Get-HardDisk -VM $vm | Copy-HardDisk "[Storage1]/"
Retrieves the hard disks of a virtual machine and copies them into the storage1 root folder.
Example 2
Copy-HardDisk -HardDisk $hdd -DestinationPath "[Storage1] vms/disks" -DestinationStorageFormat Thick
Copies the $hdd hard disk to the "vms/disks"location on storage1 and changes the storage format of the destination disk to Thick.
Related Commands
HardDisk
This cmdlet retrieves the virtual hard disks available on a vCenter Server system.
Copies a virtual hard disk to another destination.
This cmdlet moves a hard disk from one location to another.
This cmdlet modifies the properties of the specified virtual hard disk.
This cmdlet removes the specified virtual hard disks.
This cmdlet creates a new hard disk on the specified location.
