Import-VM

Import-VM

Imports a virtual machine from a file.

語法

Parameter Set: CompatibilityReport
Import-VM [-CompatibilityReport] <VMCompatibilityReport> [-AsJob] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Copy
Import-VM [-Path] <String> [[-VhdDestinationPath] <String> ] -Copy [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-GenerateNewId] [-SmartPagingFilePath <String> ] [-SnapshotFilePath <String> ] [-VhdSourcePath <String> ] [-VirtualMachinePath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Register
Import-VM [-Path] <String> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Register] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The Import-VM cmdlet imports a virtual machine from a file.

參數

-AsJob

Runs the cmdlet as a background job.

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上目前的工作階段。

-CompatibilityReport<VMCompatibilityReport>

Specifies a compatibility report which resolves any incompatibilities between the virtual machine and the Hyper-V host.

-ComputerName<String[]>

Specifies one or more Hyper-V hosts from which the virtual machine is to be imported. 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.

-Credential<System.Management.Automation.PSCredential[]>

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

-GenerateNewId

Specifies that the imported virtual machine should be copied and given a new unique identifier. (By default, Import-VM gives the new virtual machine the same unique identifier as the imported virtual machine.)

-Path<String>

Specifies the path to the exported virtual machine to be imported.

-Copy

Specifies that the imported virtual machine’s files should be copied to the server’s default locations, as opposed to registering the virtual machine in-place.

-Register

Specifies that the imported virtual machine is to be registered in-place, as opposed to copying its files to the server’s default locations. Choose this option if the virtual machines files are already in the location from which they are to run.

-SmartPagingFilePath<String>

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

-SnapshotFilePath<String>

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

-VhdDestinationPath<String>

Specifies the folder to which the virtual machine’s VHD files are to be copied.

-VhdSourcePath<String>

Specifies the folder from which the virtual machine’s VHD files are to be copied.

-VirtualMachinePath<String>

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

-Confirm

在執行指令程式之前提示您確認。

-WhatIf

示範當執行指令程式時會發生什麼事情。此指令程式並未執行。

<CommonParameters>

這個指令程式支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是可透過管道傳送至指令程式的物件類型。

• None.

輸出

輸出類型是指令程式所發出的物件類型。

• Microsoft.HyperV.PowerShell.VirtualMachine

範例

Example 1

Imports the virtual machine from its configuration file. The virtual machine is registered in-place, so its files are not copied.

PS C:\> Import-VM –Path 'D:\Test\VirtualMachines\5AE40946-3A98-428E-8C83-081A3C6BD18C.XML'

Example 2

Imports the virtual machine by copying its files to the default virtual machine and virtual hard drive storage locations of the Hyper-V host. The imported virtual machine will be given a new unique identifier, not the one in the configuration file. This is useful when you want to import multiple copies of a virtual machine, since each virtual machine must have a unique identifier.

PS C:\> Import-VM -Path 'D:\Test2\Virtual Machines\8F148B6D-C674-413E-9FCC-4FBED185C52D.XML' –Copy -GenerateNewId

Example 3

Imports a virtual machine whose configuration is not compatible with the Hyper-V host.

Attempts import of a virtual machine; the attempt fails due to incompatibilities with the Hyper-V host.

PS C:\> Import-VM -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.XML'

Gets a compatibility report that describes the attempted import and lists the virtual machine’s incompatibilities with the Hyper-V host.

PS C:\> $report = Compare-VM -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.XML'

Displays the compatibility report, revealing that the virtual network adapter was connected to switch Production. The Hyper-V host has no switch by that name.

PS C:\> $report.Incompatibilities | Format-Table -AutoSize

Disconnects the virtual network adapter.

PS C:\> $report.Incompatibilities[0].Source | Disconnect-VMNetworkAdapter

Generates a new compatibility report to determine if the virtual machine is compatible with the Hyper-V host.

PS C:\> Compare-VM –CompatibilityReport $report

Displays the compatibility report.

PS C:\> $report

Imports the virtual machine.

PS C:\> import-vm -CompatibilityReport $report