Delen via

Read-SCGuestInfo

  • Referentie
Module:
VirtualMachineManager

Haalt de waarde op die is gekoppeld aan een sleutel in een gastbesturingssysteem.

Syntaxis

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

Description

De cmdlet Read-SCGuestInfo haalt de waarde op die is gekoppeld aan een sleutel (sleutel/waardepaar) in een gastbesturingssysteem.

Voorbeelden

Voorbeeld 1: De waarde IntegrationServicesVersion ophalen voor een opgegeven sleutel voor een virtuele machine

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam $VM 01 opgehaald en wordt het object opgeslagen in de variabele $VM.

De tweede opdracht retourneert het sleutel-/waardepaar IntegrationServicesVersion voor virtuele machine VM01.

Voorbeeld 2: Haal de waarde IntegrationServicesVersion op voor een opgegeven sleutel voor een virtuele machine met behulp van de pijplijnoperator

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

Met deze opdracht wordt het sleutel-/waardepaar IntegrationServicesVersion voor virtuele machine VM01 geretourneerd.

Voorbeeld 3: Meerdere KVP-waarden ophalen op basis van opgegeven sleutels voor een virtuele machine

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

Met de eerste opdracht maakt u een matrix met de naam $ValuesMap.

Met de tweede en derde opdrachten worden waarden toegevoegd aan de $ValuesMap matrix.

Met de vierde opdracht wordt het virtuele-machineobject met de naam VM02 opgehaald en wordt het object opgeslagen in de $VM variabele.

De laatste opdracht retourneert de sleutel-/waardeparen IntegrationServicesVersion en NetworkAddressIPv4 voor virtuele machine VM02.

Voorbeeld 4: Meerdere gegevenstypen lezen via een hashtabel

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM03 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht maakt u een matrix met de naam $ValuesMap.

Met de derde opdracht wordt NetworkAddressIPv4 toegevoegd aan de $ValuesMap-matrix.

Met de vierde opdracht wordt het sleutel-/waardepaar NetworkAddressIPv4 voor VM03 opgehaald.

Met de vijfde opdracht wordt NetworkAddressIPv6 toegevoegd aan de $ValuesMap-matrix.

Met de zesde opdracht wordt het sleutel-/waardepaar NetworkAddressIPv6 voor VM03 opgehaald.

Met de zevende opdracht maakt u een matrix met de naam $ValuesMap 2 die NetworkAddressIPv4 en FullyQualifiedDomainName bevat.

Met de laatste opdracht worden de sleutel-/waardeparen voor NetworkAddressIPv4 en FullyQualifiedDomainName voor VM03 geretourneerd.

Voorbeeld 5: Sleutels lezen die niet bestaan

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt het object opgeslagen in de $VM variabele.

De tweede, vierde en zesde opdrachten maken elk een set sleutels die null zijn en slaat de set op in de $KeysDoNotExist variabele.

De derde, vijfde en zevende opdrachten lezen de KVPMap in $KeysDoNotExist en geven de resultaten weer.

Parameters

-Key

Hiermee geeft u de sleutel in een sleutel/waardepaar.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KvpMap

Hiermee geeft u een hash-tabel van sleutel-/waardeparen die overeenkomen met de waarden die worden weergegeven door Hyper-V.

Type:Hashtable
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

String

Deze cmdlet retourneert een Tekenreeks-object.