Compare-VM

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