Read-SCGuestInfo

Başvuru

Modül:: VirtualMachineManager

Konuk işletim sistemindeki bir anahtarla ilişkili değeri alır.

Syntax

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

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

Description

Read-SCGuestInfo cmdlet'i konuk işletim sistemindeki bir anahtarla (anahtar/değer çifti) ilişkili değeri alır.

Örnekler

Örnek 1: Sanal makine için belirtilen anahtar için IntegrationServicesVersion değerini alma

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

İlk komut, $VM 01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, VM01 sanal makinesi için IntegrationServicesVersion anahtar/değer çiftini döndürür.

Örnek 2: İşlem hattı işlecini kullanarak sanal makine için belirtilen anahtar için IntegrationServicesVersion değerini alma

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

Bu komut, VM01 sanal makinesi için IntegrationServicesVersion anahtar/değer çiftini döndürür.

Örnek 3: Sanal makine için belirtilen anahtarlara göre birden çok KVP değeri alma

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

İlk komut $ValuesMap adlı bir dizi oluşturur.

İkinci ve üçüncü komutlar $ValuesMap dizisine değer ekler.

Dördüncü komut, VM02 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

Son komut, VM02 sanal makinesi için IntegrationServicesVersion ve NetworkAddressIPv4 anahtar/değer çiftlerini döndürür.

Örnek 4: Karma tablo aracılığıyla birden çok veri türünü okuma

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

İlk komut VM03 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut $ValuesMap adlı bir dizi oluşturur.

Üçüncü komut, $ValuesMap dizisine NetworkAddressIPv4 ekler.

Dördüncü komut, VM03 için NetworkAddressIPv4 anahtar/değer çiftini alır.

Beşinci komut, $ValuesMap dizisine NetworkAddressIPv6 ekler.

Altıncı komut, VM03 için NetworkAddressIPv6 anahtar/değer çiftini alır.

Yedinci komut, NetworkAddressIPv4 ve FullyQualifiedDomainName içeren $ValuesMap 2 adlı bir dizi oluşturur.

Son komut, VM03 için NetworkAddressIPv4 ve FullyQualifiedDomainName anahtar/değer çiftlerini döndürür.

Örnek 5: Var olmayan anahtarları okuma

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

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci, dördüncü ve altıncı komutların her biri null olan bir anahtar kümesi oluşturur ve kümeyi $KeysDoNotExist değişkeninde depolar.

Üçüncü, beşinci ve yedinci komutlar $KeysDoNotExist'da KVPMap'i okur ve sonuçları görüntüler.

Parametreler

-Key

Anahtarı bir anahtar/değer çiftinde belirtir.

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

-KvpMap

Hyper-V tarafından kullanıma sunulan değerlere karşılık gelen anahtar/değer çiftlerinin karma tablosunu belirtir.

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

-VM

Bir sanal makine nesnesi belirtir.

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

Çıkışlar

String

Bu cmdlet bir String nesnesi döndürür.