Edit

Share via

Move-VM

Module:
Hyper-V Module

Moves a virtual machine to a new Hyper-V host.

Syntax

NameSingleDestination (Default) 

Move-VM
    [-Name] <String>
    [-DestinationHost] <String>
    [-ComputerName <String[]>]
    [-Credential <PSCredential[]>]
    [-DestinationCredential <PSCredential>]
    [-IncludeStorage]
    [-DestinationStoragePath <String>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameSingleDestinationAndCimSession 

Move-VM
    [-Name] <String>
    [-DestinationCimSession] <CimSession>
    [-CimSession <CimSession[]>]
    [-IncludeStorage]
    [-DestinationStoragePath <String>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameMultipleDestinationsAndCimSession 

Move-VM
    [-Name] <String>
    [-DestinationCimSession] <CimSession>
    -VirtualMachinePath <String>
    [-CimSession <CimSession[]>]
    [-SnapshotFilePath <String>]
    [-SmartPagingFilePath <String>]
    [-Vhds <Hashtable[]>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameMultipleDestinations 

Move-VM
    [-Name] <String>
    [-DestinationHost] <String>
    [-ComputerName <String[]>]
    [-Credential <PSCredential[]>]
    [-DestinationCredential <PSCredential>]
    [-VirtualMachinePath <String>]
    [-SnapshotFilePath <String>]
    [-SmartPagingFilePath <String>]
    [-Vhds <Hashtable[]>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CompatibilityReport 

Move-VM
    [-CompatibilityReport] <VMCompatibilityReport>
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VMSingleDestinationAndCimSession 

Move-VM
    [-VM] <VirtualMachine>
    [-DestinationCimSession] <CimSession>
    [-IncludeStorage]
    [-DestinationStoragePath <String>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VMSingleDestination 

Move-VM
    [-VM] <VirtualMachine>
    [-DestinationHost] <String>
    [-DestinationCredential <PSCredential>]
    [-IncludeStorage]
    [-DestinationStoragePath <String>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VMMultipleDestinations 

Move-VM
    [-VM] <VirtualMachine>
    [-DestinationHost] <String>
    [-DestinationCredential <PSCredential>]
    [-VirtualMachinePath <String>]
    [-SnapshotFilePath <String>]
    [-SmartPagingFilePath <String>]
    [-Vhds <Hashtable[]>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VMMultipleDestinationsAndCimSession 

Move-VM
    [-VM] <VirtualMachine>
    [-DestinationCimSession] <CimSession>
    -VirtualMachinePath <String>
    [-SnapshotFilePath <String>]
    [-SmartPagingFilePath <String>]
    [-Vhds <Hashtable[]>]
    [-ResourcePoolName <String>]
    [-RetainVhdCopiesOnSource]
    [-RemoveSourceUnmanagedVhds]
    [-AsJob]
    [-Passthru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Move-VM cmdlet moves a virtual machine to a new Hyper-V host.

Examples

Example 1: Move VM to remote computer

PS C:\> Move-VM -Name "Test VM" -DestinationHost remoteServer

Moves a virtual machine test VM to a remote computer remoteServer when the virtual machine is stored on an SMB share.

Example 2: Move VM and all storage to remote computer

PS C:\> Move-VM -Name "Test VM" -DestinationHost remoteServer -IncludeStorage -DestinationStoragePath D:\TestVM

Moves virtual machine test VM to remote computer remoteServer, and moves all files associated with the virtual machine to D:\TestVM on the remote computer.

Example 3: Move VM and specified storage file to remote computer

PS C:\> Move-VM  -Name "Test VM" -DestinationHost remoteServer -VirtualMachinePath D:\TestVM\Config -SnapshotFilePath D:\TestVM\Snapshots -SmartPagingFilePath D:\TestVM\SmartPaging -IncludeStorage -VHDs @(@{"SourceFilePath" = "C:\TestVM\Disk1.VHDX"; "DestinationFilePath" = "D:\TestVM\Disks\Disk1.VHDX"}, @{"SourceFilePath" = "C:\TestVM\Disk2.VHDX"; "DestinationFilePath" = "D:\TestVM\Disks\Disk2.VHDX"})

Moves a virtual machine Test VM to a remote computer remoteServer and places the files associated with the virtual machine in the specified locations under D:\TestVM on the remote computer.

Parameters

-AsJob

Runs the cmdlet as a background job.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Parameter properties

Type:

CimSession[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CompatibilityReport

Specifies a compatibility report which includes any adjustments required for the move.

Parameter properties

Type:VMCompatibilityReport
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CompatibilityReport
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-ComputerName

Specifies one or more Hyper-V hosts that run this cmdlet. NetBIOS names, IP addresses, and fully qualified ___domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Credential

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Parameter properties

Type:

PSCredential[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DestinationCimSession

Specifies the CIMSession on the Hyper-V host to which the virtual machine is to be moved.

Parameter properties

Type:CimSession
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestinationAndCimSession
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinationsAndCimSession
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestinationAndCimSession
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DestinationCredential

Specifies a user account that has permission to perform this action. The default is the current user.

Parameter properties

Type:PSCredential
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DestinationHost

Specifies the Hyper-V host to which the virtual machine is to be moved.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DestinationStoragePath

Specifies a destination path to which all virtual machine data is to be moved.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-IncludeStorage

Specifies that both the virtual machine and its storage are to be moved.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the friendly name of the virtual machine to be moved.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
NameSingleDestinationAndCimSession
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinationsAndCimSession
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Passthru

Specifies that an object is to be passed through to be pipeline representing the moved virtual machine.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RemoveSourceUnmanagedVhds

Indicates that Hyper-V deletes the parent virtual hard disk on the source after this cmdlet moves a differencing virtual hard disk, when the migration is finished.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResourcePoolName

Specifies the name of the processor resource pool to be used.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RetainVhdCopiesOnSource

Indicates that this cmdlet retains parent virtual hard disks on the source computer.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestinationAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SmartPagingFilePath

Specifies the new path to use for a smart paging file, if one is needed.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SnapshotFilePath

Specifies the path for any snapshot files associated with the virtual machine.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:CheckpointFileLocation, SnapshotFileLocation

Parameter sets

NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Vhds

Specifies an array of hashtables that contain locations for each individual virtual hard disk to be moved. Each hashtable should have two entries. The first entry specifies the current ___location of the virtual hard disk to move, and has a key of SourceFilePath. The second entry specifies the new ___location for the virtual hard disk, and has a key of DestinationFilePath. The virtual hard disk name must be identical in both entries.

Parameter properties

Type:

Hashtable[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NameMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualMachinePath

Specifies the path where the virtual machine configuration files are to be stored.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NameMultipleDestinationsAndCimSession
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VM

Specifies the virtual machine to be moved.

Parameter properties

Type:VirtualMachine
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

VMSingleDestinationAndCimSession
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
VMSingleDestination
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinations
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
VMMultipleDestinationsAndCimSession
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

undefined

None, by default. Microsoft.HyperV.PowerShell.VirtualMachine if the migration succeeds and -PassThru is specified. Microsoft.HyperV.PowerShell.CompatibilityReport if the migration fails because of an incompatibility.