Bagikan melalui

Read-SCGuestInfo

  • Referensi
Modul:
VirtualMachineManager

Mengambil nilai yang terkait dengan kunci dalam sistem operasi tamu.

Sintaks

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

Deskripsi

Cmdlet Read-SCGuestInfo mengambil nilai yang terkait dengan kunci (pasangan kunci/nilai) dalam sistem operasi tamu.

Contoh

Contoh 1: Dapatkan nilai IntegrationServicesVersion untuk kunci tertentu untuk komputer virtual

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

Perintah pertama mendapatkan objek komputer virtual bernama $VM 01 dan menyimpan objek dalam variabel $VM.

Perintah kedua mengembalikan pasangan kunci/nilai IntegrationServicesVersion untuk komputer virtual VM01.

Contoh 2: Dapatkan nilai IntegrationServicesVersion untuk kunci tertentu untuk komputer virtual dengan menggunakan operator alur

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

Perintah ini mengembalikan pasangan kunci/nilai IntegrationServicesVersion untuk komputer virtual VM01.

Contoh 3: Mendapatkan beberapa nilai KVP berdasarkan kunci tertentu untuk komputer virtual

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

Perintah pertama membuat array bernama $ValuesMap.

Perintah kedua dan ketiga menambahkan nilai ke array $ValuesMap.

Perintah keempat mendapatkan objek komputer virtual bernama VM02 dan menyimpan objek dalam variabel $VM.

Perintah terakhir mengembalikan pasangan kunci/nilai IntegrationServicesVersion dan NetworkAddressIPv4 untuk komputer virtual VM02.

Contoh 4: Membaca beberapa jenis data melalui hashtable

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

Perintah pertama mendapatkan objek komputer virtual bernama VM03 dan menyimpan objek dalam variabel $VM.

Perintah kedua membuat array bernama $ValuesMap.

Perintah ketiga menambahkan NetworkAddressIPv4 ke array $ValuesMap.

Perintah keempat mendapatkan pasangan kunci/nilai NetworkAddressIPv4 untuk VM03.

Perintah kelima menambahkan NetworkAddressIPv6 ke array $ValuesMap.

Perintah keenam mendapatkan pasangan kunci/nilai NetworkAddressIPv6 untuk VM03.

Perintah ketujuh membuat array bernama $ValuesMap 2 yang berisi NetworkAddressIPv4 dan FullyQualifiedDomainName.

Perintah terakhir mengembalikan pasangan kunci/nilai untuk NetworkAddressIPv4 dan FullyQualifiedDomainName untuk VM03.

Contoh 5: Membaca kunci yang tidak ada

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

Perintah pertama mendapatkan objek komputer virtual bernama VM01 dan menyimpan objek dalam variabel $VM.

Perintah kedua, keempat, dan keenam masing-masing membuat sekumpulan kunci yang null dan menyimpan set dalam variabel $KeysDoNotExist.

Perintah ketiga, kelima, dan ketujuh membaca KVPMap dalam $KeysDoNotExist dan menampilkan hasilnya.

Parameter

-Key

Menentukan kunci dalam pasangan kunci/nilai.

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

-KvpMap

Menentukan tabel hash pasangan kunci/nilai yang sesuai dengan nilai yang diekspos oleh Hyper-V.

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

-VM

Menentukan objek komputer virtual.

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

Output

String

Cmdlet ini mengembalikan objek String .