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 della 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 di $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: Leggere le chiavi 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, quarto e sesto comando creano un set di chiavi 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.

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

-KvpMap

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

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

-VM

Specifica un oggetto macchina virtuale.

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

Output

String

Questo cmdlet restituisce un oggetto String .