Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-VM
Specifies the virtual machine to be moved.
Parameter properties
| Type: | VirtualMachine |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
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
None
By default, this cmdlet doesn't return any output.
Microsoft.HyperV.PowerShell.VirtualMachine
When you use the PassThru parameter, this cmdlet returns a Microsoft.HyperV.PowerShell.VirtualMachine object if the migration is successful.
Microsoft.HyperV.PowerShell.CompatibilityReport
When you use the PassThru parameter, this cmdlet returns a Microsoft.HyperV.PowerShell.CompatibilityReport object if the migration fails because of an incompatibility.
Feedback
Was this page helpful?