Freigeben über

Read-SCGuestInfo

  • Referenz
Modul:
VirtualMachineManager

Ruft den Wert ab, der einem Schlüssel in einem Gastbetriebssystem zugeordnet ist.

Syntax

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

Beschreibung

Das cmdlet Read-SCGuestInfo ruft den Wert ab, der einem Schlüssel (Schlüssel/Wert-Paar) in einem Gastbetriebssystem zugeordnet ist.

Beispiele

Beispiel 1: Abrufen des IntegrationServicesVersion-Werts für einen angegebenen Schlüssel für einen virtuellen Computer

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

Der erste Befehl ruft das objekt des virtuellen Computers mit dem Namen $VM 01 ab und speichert das Objekt in der variablen $VM.

Der zweite Befehl gibt das IntegrationServicesVersion-Schlüssel-Wert-Paar für virtuelle Computer VM01 zurück.

Beispiel 2: Abrufen des IntegrationServicesVersion-Werts für einen angegebenen Schlüssel für einen virtuellen Computer mithilfe des Pipelineoperators

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

Dieser Befehl gibt das Schlüssel-Wertpaar IntegrationServicesVersion für vm01 des virtuellen Computers zurück.

Beispiel 3: Abrufen mehrerer KVP-Werte basierend auf angegebenen Schlüsseln für einen virtuellen Computer

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

Der erste Befehl erstellt ein Array mit dem Namen $ValuesMap.

Die zweiten und dritten Befehle fügen dem $ValuesMap Array Werte hinzu.

Der vierte Befehl ruft das Objekt des virtuellen Computers namens VM02 ab und speichert das Objekt in der $VM Variablen.

Der letzte Befehl gibt die Schlüssel-/Wertpaare "IntegrationServicesVersion" und "NetworkAddressIPv4" für vm02 zurück.

Beispiel 4: Lesen mehrerer Datentypen über eine Hashtabelle

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

Der erste Befehl ruft das Objekt des virtuellen Computers namens VM03 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl erstellt ein Array namens $ValuesMap.

Der dritte Befehl fügt NetworkAddressIPv4 zum $ValuesMap Array hinzu.

Der vierte Befehl ruft das NetworkAddressIPv4-Schlüssel-Wert-Paar für VM03 ab.

Der fünfte Befehl fügt networkAddressIPv6 dem $ValuesMap Array hinzu.

Der sechste Befehl ruft das Schlüssel-Wertpaar NetworkAddressIPv6 für VM03 ab.

Der siebte Befehl erstellt ein Array mit dem Namen $ValuesMap 2, das NetworkAddressIPv4 und FullyQualifiedDomainName enthält.

Der letzte Befehl gibt die Schlüssel-Wert-Paare für NetworkAddressIPv4 und FullyQualifiedDomainName für VM03 zurück.

Beispiel 5: Lesetasten, die nicht vorhanden sind

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

Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Die zweiten, vierten und sechsten Befehle erstellen jeweils einen Satz von Schlüsseln, die NULL sind, und speichert den Satz in der $KeysDoNotExist Variablen.

Die dritten, fünften und siebten Befehle lesen die KVPMap in $KeysDoNotExist und zeigen die Ergebnisse an.

Parameter

-Key

Gibt den Schlüssel in einem Schlüssel-Wert-Paar an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KvpMap

Gibt eine Hashtabelle mit Schlüssel-Wert-Paaren an, die den von Hyper-V verfügbar gemachten Werten entsprechen.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:VM
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

String

Dieses Cmdlet gibt ein String-Objekt zurück.