Read-SCGuestInfo
Recupera il valore associato a una chiave in un sistema operativo guest.
Sintassi
MultipleKvpKeys (impostazione predefinita).
Read-SCGuestInfo
[-VM] <VM>
-KvpMap <Hashtable>
[<CommonParameters>]
SingleKvpKey
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.
Il secondo e il terzo comando aggiungono valori alla matrice $ValuesMap.
Il quarto comando ottiene l'oggetto macchina virtuale denominato VM02 e memorizza l'oggetto nella variabile $VM.
L'ultimo comando restituisce le coppie chiave/valore IPv4 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 all'array $ValuesMap.
Il quarto comando ottiene la coppia chiave/valore NetworkAddressIPv4 per VM03.
Il quinto comando aggiunge NetworkAddressIPv6 all'array $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 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, il quarto e il sesto comando creano ciascuno un set di chiavi null e memorizzano il set nella variabile $KeysDoNotExist.
Il terzo, il quinto e il settimo comando leggono il KVPMap in $KeysDoNotExist e visualizzano i risultati.
Parametri
-Key
Specifica la chiave in una coppia chiave/valore.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
SingleKvpKey
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-KvpMap
Specifica una tabella hash di coppie chiave/valore corrispondenti ai valori esposti da Hyper-V.
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MultipleKvpKeys
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-VM
Specifica un oggetto macchina virtuale.
Proprietà dei parametri
| Tipo: | VM |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Output
String
Questo cmdlet restituisce un oggetto String .