Partager via

Read-SCGuestInfo

  • Référence
Module:
VirtualMachineManager

Récupère la valeur associée à une clé dans un système d’exploitation invité.

Syntax

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

Description

L’applet de commande Read-SCGuestInfo récupère la valeur associée à une clé (paire clé/valeur) dans un système d’exploitation invité.

Exemples

Exemple 1 : Obtenir la valeur IntegrationServicesVersion pour une clé spécifiée pour une machine virtuelle

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

La première commande obtient l’objet de machine virtuelle nommé $VM 01 et stocke l’objet dans la variable $VM.

La deuxième commande retourne la paire clé/valeur IntegrationServicesVersion pour machine virtuelle VM01.

Exemple 2 : Obtenir la valeur IntegrationServicesVersion pour une clé spécifiée pour une machine virtuelle à l’aide de l’opérateur de pipeline

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

Cette commande retourne la paire clé/valeur IntegrationServicesVersion pour la machine virtuelle VM01.

Exemple 3 : Obtenir plusieurs valeurs KVP basées sur des clés spécifiées pour une machine virtuelle

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

La première commande crée un tableau nommé $ValuesMap.

Les deuxième et troisième commandes ajoutent des valeurs au tableau $ValuesMap.

La quatrième commande obtient l’objet de machine virtuelle nommé VM02 et stocke l’objet dans la variable $VM.

La dernière commande retourne les paires clé/valeur IntegrationServicesVersion et NetworkAddressIPv4 pour la machine virtuelle VM02.

Exemple 4 : Lire plusieurs types de données via un hachage

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

La première commande obtient l’objet de machine virtuelle nommé VM03 et stocke l’objet dans la variable $VM.

La deuxième commande crée un tableau nommé $ValuesMap.

La troisième commande ajoute NetworkAddressIPv4 au tableau $ValuesMap.

La quatrième commande obtient la paire clé/valeur NetworkAddressIPv4 pour VM03.

La cinquième commande ajoute NetworkAddressIPv6 au tableau $ValuesMap.

La sixième commande obtient la paire clé/valeur NetworkAddressIPv6 pour VM03.

La septième commande crée un tableau nommé $ValuesMap 2 qui contient NetworkAddressIPv4 et FullyQualifiedDomainName.

La dernière commande retourne les paires clé/valeur pour NetworkAddressIPv4 et FullyQualifiedDomainName pour VM03.

Exemple 5 : Lire les clés qui n’existent pas

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

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.

Les deuxième, quatrième et sixième commandes créent chacun un ensemble de clés null et stockent le jeu dans la variable $KeysDoNotExist.

Les troisième, cinquième et septième commandes lisent le KVPMap dans $KeysDoNotExist et affichent les résultats.

Paramètres

-Key

Spécifie la clé dans une paire clé/valeur.

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

-KvpMap

Spécifie une table de hachage de paires clé/valeur correspondant aux valeurs exposées par Hyper-V.

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

-VM

Spécifie un objet ordinateur virtuel.

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

Sorties

String

Cette applet de commande retourne un objet String .