Condividi tramite

Read-SCGuestInfo

  • Riferimento
Modulo:
VirtualMachineManager

Recupera il valore associato a una chiave in un sistema operativo guest.

Sintassi

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

Descrizione

Il cmdlet Read-SCGuestInfo recupera il valore associato a una chiave (coppia chiave/valore) in un sistema operativo guest.

Esempio

Esempio 1: Ottenere il valore IntegrationServicesVersion per una chiave specificata per una macchina virtuale

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

Il primo comando ottiene l'oggetto macchina virtuale denominato $VM 01 e archivia l'oggetto nella variabile $VM.

Il secondo comando restituisce la coppia chiave/valore IntegrationServicesVersion per la macchina virtuale VM01.

Esempio 2: Ottenere il valore IntegrationServicesVersion per una chiave specificata per una macchina virtuale usando l'operatore pipeline

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

Questo comando restituisce la coppia chiave/valore IntegrationServicesVersion per la macchina virtuale VM01.

Esempio 3: Ottenere più valori KVP in base alle chiavi specificate per una macchina virtuale

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

Il primo comando crea una matrice denominata $ValuesMap.

I secondi e i terzi comandi aggiungono valori alla matrice $ValuesMap.

Il quarto comando ottiene l'oggetto macchina virtuale denominato VM02 e archivia l'oggetto nella variabile $VM.

L'ultimo comando restituisce le coppie chiave/valore IntegrationServicesVersion e NetworkAddressIPv4 per la macchina virtuale VM02.

Esempio 4: Leggere più tipi di dati tramite una tabella hash

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

Il primo comando ottiene l'oggetto macchina virtuale denominato VM03 e archivia l'oggetto nella variabile $VM.

Il secondo comando crea una matrice denominata $ValuesMap.

Il terzo comando aggiunge NetworkAddressIPv4 alla matrice di $ValuesMap.

Il quarto comando ottiene la coppia chiave/valore NetworkAddressIPv4 per VM03.

Il quinto comando aggiunge NetworkAddressIPv6 alla matrice di $ValuesMap.

Il sesto comando ottiene la coppia chiave/valore NetworkAddressIPv6 per VM03.

Il settimo comando crea una matrice denominata $ValuesMap 2 che contiene NetworkAddressIPv4 e FullyQualifiedDomainName.

L'ultimo comando restituisce le coppie chiave/valore per NetworkAddressIPv4 e FullyQualifiedDomainName per VM03.

Esempio 5: Chiavi di lettura che non esistono

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

Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e archivia l'oggetto nella variabile $VM.

Il secondo, il quarto e il sesto comando creano ogni set di chiavi che sono Null e archivia il set nella variabile $KeysDoNotExist.

Il terzo, quinto e settimo comando legge il KVPMap in $KeysDoNotExist e visualizza i risultati.

Parametri

-Key

Specifica la chiave in una coppia chiave/valore.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KvpMap

Specifica una tabella hash di coppie chiave/valore corrispondenti ai valori esposti da Hyper-V.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VM

Specifica un oggetto macchina virtuale.

Tipo:VM
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

String

Questo cmdlet restituisce un oggetto string .