Udostępnij za pośrednictwem

Read-SCGuestInfo

  • Odwołanie
Moduł:
VirtualMachineManager

Pobiera wartość skojarzona z kluczem w systemie operacyjnym gościa.

Składnia

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

Opis

Polecenie cmdlet Read-SCGuestInfo pobiera wartość skojarzona z kluczem (parą klucz/wartość) w systemie operacyjnym gościa.

Przykłady

Przykład 1. Pobieranie wartości IntegrationServicesVersion dla określonego klucza dla maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie $VM 01 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie zwraca parę klucz/wartość IntegrationServicesVersion dla maszyny wirtualnej VM01.

Przykład 2. Pobieranie wartości IntegrationServicesVersion dla określonego klucza maszyny wirtualnej przy użyciu operatora potoku

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

To polecenie zwraca parę klucz/wartość IntegrationServicesVersion dla maszyny wirtualnej VM01.

Przykład 3. Pobieranie wielu wartości KVP na podstawie określonych kluczy dla maszyny wirtualnej

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

Pierwsze polecenie tworzy tablicę o nazwie $ValuesMap.

Drugie i trzecie polecenia dodają wartości do tablicy $ValuesMap.

Czwarte polecenie pobiera obiekt maszyny wirtualnej o nazwie VM02 i przechowuje obiekt w zmiennej $VM.

Ostatnie polecenie zwraca pary klucz/wartość parametru IntegrationServicesVersion i NetworkAddressIPv4 dla maszyny wirtualnej VM02.

Przykład 4. Odczytywanie wielu typów danych za pomocą tabeli skrótowej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM03 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie tworzy tablicę o nazwie $ValuesMap.

Trzecie polecenie dodaje parametr NetworkAddressIPv4 do tablicy $ValuesMap.

Czwarte polecenie pobiera parę klucz/wartość NetworkAddressIPv4 dla maszyny wirtualnej VM03.

Piąte polecenie dodaje parametr NetworkAddressIPv6 do tablicy $ValuesMap.

Szóste polecenie pobiera parę klucz/wartość NetworkAddressIPv6 dla maszyny wirtualnej VM03.

Siódme polecenie tworzy tablicę o nazwie $ValuesMap 2 zawierającą ciąg NetworkAddressIPv4 i FullyQualifiedDomainName.

Ostatnie polecenie zwraca pary klucz/wartość dla parametrów NetworkAddressIPv4 i FullyQualifiedDomainName dla maszyny wirtualnej VM03.

Przykład 5. Klucze odczytu, które nie istnieją

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.

Drugie, czwarte i szóste polecenia tworzą zestaw kluczy o wartości null i przechowuje zestaw w zmiennej $KeysDoNotExist.

Trzecie, piąte i siódme polecenia odczytują KVPMap w $KeysDoNotExist i wyświetlają wyniki.

Parametry

-Key

Określa klucz w parze klucz/wartość.

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

-KvpMap

Określa tabelę skrótów par klucz/wartość odpowiadającą wartościom udostępnianym przez funkcję Hyper-V.

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

-VM

Określa obiekt maszyny wirtualnej.

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

Dane wyjściowe

String

To polecenie cmdlet zwraca obiekt String .