Move-SCVirtualHardDisk

Syntax

Move-SCVirtualHardDisk
    [-VMMServer <ServerConnection>]
    -Bus <Byte>
    -LUN <Byte>
    [-SCSI]
    -JobGroup <Guid>
    -Path <String>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Move-SCVirtualHardDisk
    [-VMMServer <ServerConnection>]
    -Bus <Byte>
    -LUN <Byte>
    [-IDE]
    -JobGroup <Guid>
    -Path <String>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Move-SCVirtualHardDisk
    [-VirtualHardDisk] <StandaloneVirtualHardDisk>
    [-JobGroup <Guid>]
    -Path <String>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

The Move-SCVirtualHardDisk cmdlet moves a Windows-based virtual hard disk file (a .vhd file) or a VMware-based virtual hard disk file (a .vmdk file) from one location to another on the same host. You can also use Move-SCVirtualHardDisk with the Move-SCVirtualMachine cmdlet to move a virtual hard disk file to a location on a different host.

You can use this cmdlet to perform the following tasks:

• Move a virtual hard disk on a running VMware virtual machine with no service interruption.

• Move a virtual hard disk on a running Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016 virtual machine with minimal service interruption. In this case, use Move-SCVirtualHardDisk with Move-SCVirtualMachine.

• Move a virtual hard disk on a virtual machine on any type of host if the virtual machine is in a stopped state or in a saved state. In this case, use Move-SCVirtualHardDisk with Set-SCVirtualMachine. This option is supported if either of the following conditions are true:

-- The virtual machine is on a host that uses Windows Server 2008 R2, Windows Server 2012, or Windows Server 2016 Hyper-V technology or on a VMware ESX host, and the virtual machine is in a saved state or in a stopped state.

-- The virtual machine is on any other supported host, and it is in a stopped state.

Usage examples:

• If a host has multiple physical disk drives and the virtual machine has two virtual hard disks (one disk might contain the operating system and the other disk might contain data), you can use this cmdlet to move one of the virtual hard disks to a different physical hard drive in order to improve performance for both virtual hard disks.

• If the virtual machine has one dynamically expanding virtual hard disk and you discover that the virtual hard disk has expanded to a point where it uses most of the space on its current physical hard disk on the host, you can use this cmdlet to move the expanded virtual hard disk to a larger physical hard disk if one is available on the host.

Examples

Example 1: Move a virtual hard disk file from one location to another on the same host

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VHD = $VM.VirtualHardDisks[0]
PS C:\> Move-SCVirtualHardDisk -VirtualHardDisk $VHD -Path "C:\VHDs"

The first command gets the virtual machine object named VM01 and stores the object in the $VM variable.

The second command stores the first virtual hard disk object on VM01 in the $VHD variable.

The last command moves the virtual hard disk stored in $VHD to the existing folder "C:\VHDs".

Parameters

-Bus

-IDE

-JobGroup

-JobVariable

-LUN

-Path

-PROTipID

-RunAsynchronously

-SCSI

-VirtualHardDisk

-VMMServer

Outputs

VirtualHardDisk

This cmdlet returns a VirtualHardDisk object.

Related Links

• Compress-SCVirtualDiskDrive
• Copy-SCVirtualHardDisk
• Get-SCVirtualHardDisk
• Get-SCVirtualMachine
• Remove-SCVirtualHardDisk
• Set-SCVirtualHardDisk