From 689ab24dfce50ccf597be547cf5cf0ea421b7081 Mon Sep 17 00:00:00 2001 From: Andres Mariano Gorzelany <36666927+get-itips@users.noreply.github.com> Date: Fri, 7 Jun 2019 15:26:10 -0300 Subject: [PATCH 1/3] Changed xml to newly vcmx format --- docset/windows/hyper-v/import-vm.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docset/windows/hyper-v/import-vm.md b/docset/windows/hyper-v/import-vm.md index 5cc96d5cbc..97b4fc58be 100644 --- a/docset/windows/hyper-v/import-vm.md +++ b/docset/windows/hyper-v/import-vm.md @@ -51,7 +51,7 @@ The **Import-VM** cmdlet imports a virtual machine from a file. ### Example 1 ``` -PS C:\> Import-VM -Path 'D:\Test\VirtualMachines\5AE40946-3A98-428E-8C83-081A3C6BD18C.XML' +PS C:\> Import-VM -Path 'C:\\2B91FEB3-F1E0-4FFF-B8BE-29CED892A95A.vmcx' ``` Imports the virtual machine from its configuration file. @@ -59,7 +59,7 @@ The virtual machine is registered in-place, so its files are not copied. ### Example 2 ``` -PS C:\> Import-VM -Path 'D:\Test2\Virtual Machines\8F148B6D-C674-413E-9FCC-4FBED185C52D.XML' -Copy -GenerateNewId +PS C:\> Import-VM -Path 'C:\\2B91FEB3-F1E0-4FFF-B8BE-29CED892A95A.vmcx' -Copy -GenerateNewId ``` Imports the virtual machine by copying its files to the default virtual machine and virtual hard drive storage locations of the Hyper-V host. @@ -69,7 +69,7 @@ This is useful when you want to import multiple copies of a virtual machine, sin ### Example 3 ``` 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' +PS C:\> Import-VM -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.VCMX' Import-VM : Unable to import virtual machine due to configuration errors. Please use Compare-VM to repair the virtual machine. At line:1 char:1 + import-vm -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.XM ... @@ -78,7 +78,7 @@ At line:1 char:1 + FullyQualifiedErrorId : Microsoft.HyperV.PowerShell.Commands.ImportVMCommand 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' +PS C:\> $report = Compare-VM -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.VCMX' 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. @@ -100,7 +100,7 @@ PS C:\> $report VM : Microsoft.HyperV.PowerShell.VirtualMachine OperationType : ImportVirtualMachine Destination : HYPER-V-1 -Path : D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.XML +Path : D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.vcmx SnapshotPath : D:\vm1\Snapshots VhdDestinationPath : VhdSourcePath : From f776ee52b90d2a1ce48fb9ee8af8c89682435105 Mon Sep 17 00:00:00 2001 From: Andres Mariano Gorzelany <36666927+get-itips@users.noreply.github.com> Date: Mon, 10 Jun 2019 16:03:48 -0300 Subject: [PATCH 2/3] Fixed example 3 --- docset/windows/hyper-v/import-vm.md | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/docset/windows/hyper-v/import-vm.md b/docset/windows/hyper-v/import-vm.md index 97b4fc58be..4372d20372 100644 --- a/docset/windows/hyper-v/import-vm.md +++ b/docset/windows/hyper-v/import-vm.md @@ -68,7 +68,6 @@ This is useful when you want to import multiple copies of a virtual machine, sin ### Example 3 ``` -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.VCMX' Import-VM : Unable to import virtual machine due to configuration errors. Please use Compare-VM to repair the virtual machine. At line:1 char:1 @@ -76,22 +75,29 @@ At line:1 char:1 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : NotSpecified: (:) [Import-VM], VirtualizationOperationFailedException + FullyQualifiedErrorId : Microsoft.HyperV.PowerShell.Commands.ImportVMCommand +``` +Attempts import of a virtual machine; the attempt fails due to incompatibilities with the Hyper-V host. -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.VCMX' +``` +Gets a compatibility report that describes the attempted import and lists the virtual machine's incompatibilities with the Hyper-V host. - -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 Message MessageId Source ------- --------- ------ Could not find Ethernet switch 'Production'. 33012 Microsoft.HyperV.PowerShell.VMNetworkAdapter +``` +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. -Disconnects the virtual network adapter. +``` PS C:\> $report.Incompatibilities[0].Source | Disconnect-VMNetworkAdapter +``` +Disconnects the virtual network adapter. -Generates a new compatibility report to determine if the virtual machine is compatible with the Hyper-V host. +``` PS C:\> Compare-VM -CompatibilityReport $report @@ -105,15 +111,17 @@ SnapshotPath : D:\vm1\Snapshots VhdDestinationPath : VhdSourcePath : Incompatibilities : +``` +Generates a new compatibility report to determine if the virtual machine is compatible with the Hyper-V host. +``` Imports the virtual machine. PS C:\> import-vm -CompatibilityReport $report Name State CPUUsage(%) MemoryAssigned(M) MemoryDemand(M) MemoryStatus Uptime Status ReplicationState ---- ----- ----------- ----------------- --------------- ------------ ------ ------ ---------------- VM1 Off 0 0 0 00:00:00 Operating normally Disabled ``` - -Imports a virtual machine whose configuration is not compatible with the Hyper-V host. +Imports a virtual machine whose configuration is now compatible with the Hyper-V host. ## PARAMETERS From cf4f2494ac8097f53d1c064b903644660f5e3f96 Mon Sep 17 00:00:00 2001 From: Andres Mariano Gorzelany <36666927+get-itips@users.noreply.github.com> Date: Tue, 11 Jun 2019 21:30:52 -0300 Subject: [PATCH 3/3] Removed example 3 --- docset/windows/hyper-v/import-vm.md | 57 ----------------------------- 1 file changed, 57 deletions(-) diff --git a/docset/windows/hyper-v/import-vm.md b/docset/windows/hyper-v/import-vm.md index 4372d20372..8e96a4e20d 100644 --- a/docset/windows/hyper-v/import-vm.md +++ b/docset/windows/hyper-v/import-vm.md @@ -66,63 +66,6 @@ Imports the virtual machine by copying its files to the default virtual machine 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. -### Example 3 -``` -PS C:\> Import-VM -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.VCMX' -Import-VM : Unable to import virtual machine due to configuration errors. Please use Compare-VM to repair the virtual machine. -At line:1 char:1 -+ import-vm -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.XM ... -+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - + CategoryInfo : NotSpecified: (:) [Import-VM], VirtualizationOperationFailedException - + FullyQualifiedErrorId : Microsoft.HyperV.PowerShell.Commands.ImportVMCommand -``` -Attempts import of a virtual machine; the attempt fails due to incompatibilities with the Hyper-V host. - -``` -PS C:\> $report = Compare-VM -Path 'D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.VCMX' -``` -Gets a compatibility report that describes the attempted import and lists the virtual machine's incompatibilities with the Hyper-V host. - -``` -PS C:\> $report.Incompatibilities | Format-Table -AutoSize -Message MessageId Source -------- --------- ------ -Could not find Ethernet switch 'Production'. 33012 Microsoft.HyperV.PowerShell.VMNetworkAdapter -``` -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[0].Source | Disconnect-VMNetworkAdapter -``` -Disconnects the virtual network adapter. - - -``` -PS C:\> Compare-VM -CompatibilityReport $report - - -Displays the compatibility report. -PS C:\> $report -VM : Microsoft.HyperV.PowerShell.VirtualMachine -OperationType : ImportVirtualMachine -Destination : HYPER-V-1 -Path : D:\vm1\Virtual Machines\53EAE599-4D3B-4923-B173-6AEA29CB7F42.vcmx -SnapshotPath : D:\vm1\Snapshots -VhdDestinationPath : -VhdSourcePath : -Incompatibilities : -``` -Generates a new compatibility report to determine if the virtual machine is compatible with the Hyper-V host. - -``` -Imports the virtual machine. -PS C:\> import-vm -CompatibilityReport $report -Name State CPUUsage(%) MemoryAssigned(M) MemoryDemand(M) MemoryStatus Uptime Status ReplicationState ----- ----- ----------- ----------------- --------------- ------------ ------ ------ ---------------- -VM1 Off 0 0 0 00:00:00 Operating normally Disabled -``` -Imports a virtual machine whose configuration is now compatible with the Hyper-V host. - ## PARAMETERS ### -AsJob