다음을 통해 공유


Read-SCGuestInfo

게스트 운영 체제의 키와 연결된 값을 검색합니다.

Syntax

Read-SCGuestInfo
    [-VM] <VM>
    -KvpMap <Hashtable>
    [<CommonParameters>]
Read-SCGuestInfo
    [-VM] <VM>
    [-Key] <String>
    [<CommonParameters>]

Description

Read-SCGuestInfo cmdlet은 게스트 운영 체제에서 키(키/값 쌍)와 연결된 값을 검색합니다.

예제

예제 1: 가상 머신에 대해 지정된 키에 대한 IntegrationServicesVersion 값 가져오기

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCGuestInfo -VM $VM -Key "FullyQualifiedDomainName"

첫 번째 명령은 $VM 01이라는 가상 머신 개체를 가져오고 $VM 변수에 개체를 저장합니다.

두 번째 명령은 가상 머신 VM01에 대한 IntegrationServicesVersion 키/값 쌍을 반환합니다.

예제 2: 파이프라인 연산자를 사용하여 가상 머신의 지정된 키에 대한 IntegrationServicesVersion 값 가져오기

PS C:\> Get-SCVirtualMachine -Name "VM01" | Read-SCGuestInfo -Key IntegrationServicesVersion

이 명령은 가상 머신 VM01에 대한 IntegrationServicesVersion 키/값 쌍을 반환합니다.

예제 3: 가상 머신에 대해 지정된 키를 기반으로 여러 KVP 값 가져오기

PS C:\> $ValuesMap = @{}
PS C:\> $ValuesMap.Add("NetworkAddressIPv4", $Null)
PS C:\> $ValuesMap.Add("IntegrationServicesVersion", $Null)
PS C:\> $VM = Get-SCVirtualMachine "VM02" 
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap

첫 번째 명령은 $ValuesMap 배열을 만듭니다.

두 번째 및 세 번째 명령은 $ValuesMap 배열에 값을 추가합니다.

네 번째 명령은 VM02라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

마지막 명령은 가상 머신 VM02에 대한 IntegrationServicesVersion 및 NetworkAddressIPv4 키/값 쌍을 반환합니다.

예제 4: 해시 테이블을 통해 여러 데이터 형식 읽기

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $ValuesMap = @{}
PS C:\> $ValuesMap.Add("NetworkAddressIPv4", $Null)
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> $ValuesMap.Add("NetworkAddressIPv6", $Null)
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> $ValuesMap2 = @{"NetworkAddressIPv4" = $Null; "FullyQualifiedDomainName" = $Null}
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap2

첫 번째 명령은 VM03이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 $ValuesMap 배열을 만듭니다.

세 번째 명령은 $ValuesMap 배열에 NetworkAddressIPv4를 추가합니다.

네 번째 명령은 VM03에 대한 NetworkAddressIPv4 키/값 쌍을 가져옵니다.

다섯 번째 명령은 $ValuesMap 배열에 NetworkAddressIPv6을 추가합니다.

여섯 번째 명령은 VM03에 대한 NetworkAddressIPv6 키/값 쌍을 가져옵니다.

일곱 번째 명령은 NetworkAddressIPv4 및 FullyQualifiedDomainName을 포함하는 $ValuesMap 2라는 배열을 만듭니다.

마지막 명령은 VM03의 경우 NetworkAddressIPv4 및 FullyQualifiedDomainName에 대한 키/값 쌍을 반환합니다.

예제 5: 존재하지 않는 키 읽기

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $KeysDoNotExist = @{"o1ff1" = $Null; "o1ff2" = $Null; "o1ff3" = $Null ; "o1ff4" = $Null }
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist 
PS C:\> $KeysDoNotExist = @{"off4" = $Null; "o1ff2" = $Null; "o1ff3" = $Null ; "o1ff4" = $Null }
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist 
PS C:\> $KeysDoNotExist = @{"o1ff1" = $Null; "o1ff2" = $Null; "off4" = $Null ; "o1ff4" = $Null }
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist

첫 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째, 네 번째 및 여섯 번째 명령은 각각 null인 키 집합을 만들고 집합을 $KeysDoNotExist 변수에 저장합니다.

세 번째, 다섯 번째 및 일곱 번째 명령은 $KeysDoNotExist KVPMap을 읽고 결과를 표시합니다.

매개 변수

-Key

키/값 쌍의 키를 지정합니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-KvpMap

Hyper-V에서 노출하는 값에 해당하는 키/값 쌍의 해시 테이블을 지정합니다.

Type:Hashtable
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

가상 컴퓨터 개체를 지정합니다.

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

출력

String

이 cmdlet은 String 개체를 반환합니다.