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/Wertpaar) 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 virtuelle Computerobjekt namens $VM 01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl gibt das IntegrationServicesVersion-Schlüssel-/Wertpaar für virtuellen 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 IntegrationServicesVersion-Schlüssel-/Wertpaar für virtuellen Computer VM01 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 namens $ValuesMap.

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

Der vierte Befehl ruft das virtuelle Computerobjekt namens VM02 ab und speichert das Objekt in der $VM Variablen.

Der letzte Befehl gibt die IntegrationServicesVersion- und NetworkAddressIPv4-Schlüssel-/Wertpaare für virtuelle Computer VM02 zurück.

Beispiel 4: Lesen mehrerer Datentypen über eine 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

Der erste Befehl ruft das virtuelle Computerobjekt namens VM03 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl erstellt ein Array namens $ValuesMap.

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

Der vierte Befehl ruft das NetzwerkAddressIPv4-Schlüssel-/Wertpaar für VM03 ab.

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

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

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

Der letzte Befehl gibt die Schlüssel-/Wertpaare 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 virtuelle Computerobjekt namens VM01 ab und speichert das Objekt in der $VM Variable.

Der zweite, vierte und sechste Befehl erstellt jeweils eine Reihe von Schlüsseln, die null sind und den Satz in der $KeysDoNotExist Variablen speichert.

Der dritte, fünfte und siebte Befehl liest die KVPMap in $KeysDoNotExist und zeigt die Ergebnisse an.

Parameter

-Key

Gibt den Schlüssel in einem Schlüssel-/Wertpaar an.

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

-KvpMap

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

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

-VM

Gibt ein Objekt virtueller Maschinen an.

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

Ausgaben

String

Dieses Cmdlet gibt ein String-Objekt zurück.