Compare-VM
Compares a virtual machine and a virtual machine host for compatibility, returning a compatibility report.
语法
Parameter Set: CompatibilityReport
Compare-VM [-CompatibilityReport] <VMCompatibilityReport> [-AsJob] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Copy
Compare-VM [-Path] <String> [[-VhdDestinationPath] <String> ] -Copy [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-GenerateNewId] [-SmartPagingFilePath <System.String> ] [-SnapshotFilePath <System.String> ] [-VhdSourcePath <String> ] [-VirtualMachinePath <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: NameMultipleDestinations
Compare-VM [-Name] <System.String> [-DestinationHost] <System.String> [-AsJob] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-DestinationCredential <System.Management.Automation.PSCredential> ] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-SmartPagingFilePath <System.String> ] [-SnapshotFilePath <System.String> ] [-Vhds <System.Collections.Hashtable[]> ] [-VirtualMachinePath <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: NameMultipleDestinationsAndCimSession
Compare-VM [-Name] <System.String> [-DestinationCimSession] <Microsoft.Management.Infrastructure.CimSession> -VirtualMachinePath <System.String> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-SmartPagingFilePath <System.String> ] [-SnapshotFilePath <System.String> ] [-Vhds <System.Collections.Hashtable[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: NameSingleDestination
Compare-VM [-Name] <System.String> [-DestinationHost] <System.String> [-AsJob] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-DestinationCredential <System.Management.Automation.PSCredential> ] [-DestinationStoragePath <System.String> ] [-IncludeStorage] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: NameSingleDestinationAndCimSession
Compare-VM [-Name] <System.String> [-DestinationCimSession] <Microsoft.Management.Infrastructure.CimSession> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-DestinationStoragePath <System.String> ] [-IncludeStorage] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Register
Compare-VM [-Path] <String> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Register] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMMultipleDestinations
Compare-VM [-VM] <Microsoft.HyperV.PowerShell.VirtualMachine> [-DestinationHost] <System.String> [-AsJob] [-DestinationCredential <System.Management.Automation.PSCredential> ] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-SmartPagingFilePath <System.String> ] [-SnapshotFilePath <System.String> ] [-Vhds <System.Collections.Hashtable[]> ] [-VirtualMachinePath <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMMultipleDestinationsAndCimSession
Compare-VM [-VM] <Microsoft.HyperV.PowerShell.VirtualMachine> [-DestinationCimSession] <Microsoft.Management.Infrastructure.CimSession> -VirtualMachinePath <System.String> [-AsJob] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-SmartPagingFilePath <System.String> ] [-SnapshotFilePath <System.String> ] [-Vhds <System.Collections.Hashtable[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMSingleDestination
Compare-VM [-VM] <Microsoft.HyperV.PowerShell.VirtualMachine> [-DestinationHost] <System.String> [-AsJob] [-DestinationCredential <System.Management.Automation.PSCredential> ] [-DestinationStoragePath <System.String> ] [-IncludeStorage] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMSingleDestinationAndCimSession
Compare-VM [-VM] <Microsoft.HyperV.PowerShell.VirtualMachine> [-DestinationCimSession] <Microsoft.Management.Infrastructure.CimSession> [-AsJob] [-DestinationStoragePath <System.String> ] [-IncludeStorage] [-ResourcePoolName <System.String> ] [-RetainVhdCopiesOnSource] [-Confirm] [-WhatIf] [ <CommonParameters>]
详细说明
The Compare-VM cmdlet compares a virtual machine and a virtual machine host for compatibility, returning a compatibility report. This is useful when trying to import or migrate a virtual machine that is incompatible with the target server that runs Hyper-V.
参数
-AsJob
Runs the cmdlet as a background job.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-CimSession<Microsoft.Management.Infrastructure.CimSession[]>
在远程会话中或远程计算机上运行该 cmdlet。输入计算机名或会话对象，如 New-cimsession 或 Get-cimsession cmdlet 的输出。默认为本地计算机上的当前会话。
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-CompatibilityReport<VMCompatibilityReport>
Specifies a compatibility report which resolves any incompatibilities between the virtual machine and the virtual machine host.
别名 |
none |
是否必需？ |
true |
在哪里？ |
1 |
默认值 |
none |
是否接受管道输入？ |
True (ByValue) |
是否接受通配符？ |
false |
-ComputerName<System.String[]>
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.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Credential<System.Management.Automation.PSCredential[]>
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-DestinationCimSession<Microsoft.Management.Infrastructure.CimSession>
Specifies the CIMSession on the Hyper-V host to which this cmdlet compares the virtual machine for compatibility.
别名 |
none |
是否必需？ |
true |
在哪里？ |
2 |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-DestinationCredential<System.Management.Automation.PSCredential>
Specifies a user account that has permission to perform this action. The default is the current user.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-DestinationHost<System.String>
Specifies the Hyper-V host to which the virtual machine is to be compared for compatibility.
别名 |
none |
是否必需？ |
true |
在哪里？ |
2 |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-DestinationStoragePath<System.String>
Specifies a destination storage path to which all virtual machine storage is to be moved.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-GenerateNewId
Specifies that the virtual machine should be copied and given a new unique identifier.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-IncludeStorage
Specifies that the compatibility comparison should include both the virtual machine and its storage.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Name<System.String>
Specifies the name of the virtual machine to be compared.
别名 |
none |
是否必需？ |
true |
在哪里？ |
1 |
默认值 |
none |
是否接受管道输入？ |
true(ByValue) |
是否接受通配符？ |
false |
-Path<String>
Specifies the path to the configuration file of the virtual machine to be compared.
别名 |
none |
是否必需？ |
true |
在哪里？ |
1 |
默认值 |
none |
是否接受管道输入？ |
True (ByValue) |
是否接受通配符？ |
false |
-Copy
Specifies that the comparison should be made for a copy import operation.
别名 |
none |
是否必需？ |
true |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Register
Specifies that the comparison should be made for an in-place import operation.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-ResourcePoolName<System.String>
Specifies the friendly name of the resource pool.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-RetainVhdCopiesOnSource
Indicates that this cmdlet retains parent virtual hard disks on the source computer.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-SmartPagingFilePath<System.String>
Specifies the new path to use for a smart paging file, if one is needed.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-SnapshotFilePath<System.String>
Specifies the path for any snapshot files associated with the virtual machine.
别名 |
CheckpointFileLocation,SnapshotFileLocation |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-VhdDestinationPath<String>
Specifies the folder to which the virtual machine’s VHD is to be copied.
别名 |
none |
是否必需？ |
false |
在哪里？ |
2 |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Vhds<System.Collections.Hashtable[]>
Specifies an array of hash tables that specifies a location for each individual virtual hard disk that needs to be compared. Each hash table has 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 names must be identical in both entries.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-VhdSourcePath<String>
Specifies the folder from which the virtual machine’s VHD files are to be copied.
别名 |
none |
是否必需？ |
false |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-VirtualMachinePath<System.String>
Specifies the path where the resulting virtual machine configuration files are to be stored.
别名 |
none |
是否必需？ |
true |
在哪里？ |
named |
默认值 |
none |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-VM<Microsoft.HyperV.PowerShell.VirtualMachine>
Specifies a virtual machine.
别名 |
none |
是否必需？ |
true |
在哪里？ |
1 |
默认值 |
none |
是否接受管道输入？ |
true(ByValue) |
是否接受通配符？ |
false |
-Confirm
在运行 cmdlet 前提示你进行确认。
是否必需？ |
false |
在哪里？ |
named |
默认值 |
false |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-WhatIf
显示在 cmdlet 运行时将发生的情况。该 cmdlet 不运行。
是否必需？ |
false |
在哪里？ |
named |
默认值 |
false |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持常见的参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 TechNet 上的 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
输入
输入类型是可以传送到 cmdlet 的对象的类型。
输出
输出类型是 cmdlet 发出的对象的类型。
- Microsoft.HyperV.PowerShell.CompatibilityReport
示例
Example 1
Compares virtual machine TestVM and Hyper-V host TestDestinationHost for compatibility.
PS C:\> Compare-VM –Name TestVM –DestinationHost TestDestinationHost
Example 2
Imports a virtual machine whose configuration is not compatible with the Hyper-V host. Note the use of Compare-VM to troubleshoot the import failure in the first step.
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