Set-SCGuestInfo
Définit la valeur associée à une clé pour une paire clé/valeur dans un système d’exploitation invité.
Syntax
Set-SCGuestInfo
[-VM] <VM>
-KvpMap <Hashtable>
[<CommonParameters>] Set-SCGuestInfo
[-VM] <VM>
[-Key] <String>
[[-Value] <String>]
[<CommonParameters>] Description
L’applet de commande Set-SCGuestInfo définit la valeur associée à une clé pour une paire clé/valeur dans un système d’exploitation invité.
Exemples
Exemple 1 : Définir une paire clé/valeur unique
PS C:\> $VM = Get-SCVirtualMachine "VM01"
PS C:\> Set-SCGuestInfo -VM $VM -Key Key -Value ValueLa première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande définit une paire clé/valeur pour VM01.
Exemple 2 : Définir une clé sur une valeur pour une paire clé/valeur
PS C:\> Get-SCVirtualMachine -Name "VM01" | Set-SCGuestInfo -Key Microsoft.Lab.Isolation.ServerVersion -Value 1.0.1101Cette commande définit la clé sur Microsoft.Lab.Isolation.ServerVersion et la valeur sur 1.0.1101 pour la machine virtuelle nommée VM01. Si la clé n’existe pas, elle est créée avec la valeur spécifiée. Si la clé existe déjà, sa valeur est remplacée à l’aide de la valeur spécifiée dans cette commande.
Vous pouvez utiliser l’applet de commande Read-SCGuestInfo pour fournir la clé et retourner sa valeur correspondante.
Exemple 3 : Définir plusieurs paires clé/valeur
PS C:\> $VM = Get-SCVirtualMachine -Name "Win2k8R2"
PS C:\> $ValuesMap = @{"Key1" = "avalue1"; "Key2IsEmptyString" = "" ; "Key3" = "value3"}
PS C:\> Set-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap | Select KvpMapLa première commande obtient l’objet de machine virtuelle nommé Win2k8R2 et stocke l’objet dans la variable $VM.
La deuxième commande crée une table de hachage nommée $ValuesMap qui contient les clés et valeurs correspondantes pour les paires clé/valeur. Les valeurs peuvent être définies sur une chaîne, une chaîne vide ou $Null. La définition d’une valeur pour $Null supprime la clé.
La troisième commande définit les paires clé/valeur pour la machine virtuelle nommée Win2k8R2.
La dernière commande lit les paires clé/valeur pour la machine virtuelle nommée Win2k8R2.
Exemple 4 : Modifier un ensemble de valeurs pour un ensemble de paires clé/valeur
PS C:\> $VM = Get-SCVirtualMachine -Name "Win2k8R2"
PS C:\> $ValuesMap = @{"Key1" = "avalue1"; "Key2IsEmptyString" = "" ; "Key3" = "value3"}
PS C:\> Set-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap | Select KvpMap
PS C:\> $ValuesMap = @{"Key2IsEmptyString" = "KeyIsNoLongerEmpty"}
PS C:\> Set-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> $ValuesMap = @{"Key1" = $Null; "Key2IsEmptyString" = $Null; "Key3" = $Null}
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap | Select KvpMapLa première commande obtient l’objet de machine virtuelle nommé Win2k8R2 et stocke l’objet dans la variable $VM.
La deuxième commande crée une table de hachage nommée $ValuesMap qui contient les clés et valeurs correspondantes pour les paires clé/valeur. Les valeurs peuvent être définies sur une chaîne, une chaîne vide ou $Null. La définition d’une valeur pour $Null supprime la clé.
La troisième commande définit les paires clé/valeur pour la machine virtuelle nommée Win2k8R2.
La quatrième commande lit les paires clé/valeur pour la machine virtuelle nommée Win2k8R2.
La cinquième commande crée une table de hachage où une clé spécifique est remplacée par une valeur différente.
La sixième commande définit la valeur modifiée pour la clé spécifiée dans la table de hachage.
Les deux dernières commandes lisent les paires clé/valeur pour la machine virtuelle nommée Win2k8R2, y compris la valeur modifiée de la clé Key2IsEmptyString.
Exemple 5 : Supprimer une paire clé/valeur à l’aide de deux méthodes
PS C:\> $VM = Get-SCVirtualMachine -Name "Win2k8R2"
PS C:\> $ValuesMap = @{"Key1" = "avalue1"; "Key2" = "avalue2"}
PS C:\> Set-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap | Select KvpMap
PS C:\> Set-SCGuestInfo -VM $VM -Key Key1
PS C:\> $KvpsToDelete = @{"Key2" = $Null}
PS C:\> Set-SCGuestInfo -VM $VM -KvpMap $KvpsToDelete
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap | Select KvpMapLa première commande obtient l’objet de machine virtuelle nommé Win2k8R2 et stocke l’objet dans la variable $VM.
Les trois commandes suivantes créent deux clés et leurs valeurs et les retournent à la console de la machine virtuelle Win2k8R2.
La cinquième commande supprime la paire clé/valeur Key1 en appelant Set-SCGuestInfo sans spécifier le paramètre de valeur.
Les sixième et septième commandes créent une table de hachage avec Null comme valeur de clé Key2. Ensuite, la clé Key2 est supprimée en appelant l’applet de commande Set-SCGuestInfo .
La dernière commande indique que les deux clés qui ont été initialement créées sont désormais supprimées via deux méthodes distinctes.
Exemple 6 : Définir plusieurs valeurs où une valeur est vide
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $ValuesMap3 = @{"VSLM1" = "value1"; "VLSM2" = "value2" ; "VLSM3" = "value3" ; "VLDM4" = ""}
PS C:\> Set-SCGuestInfo -VM $VM -KVPMap $ValuesMap3
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $ValuesMap3 | Select KVPMapLa première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande crée une table de hachage nommée $ValuesMap 3 qui contient les clés et valeurs correspondantes pour les paires clé/valeur. Les valeurs peuvent être définies sur une chaîne, une chaîne vide ou $Null. La définition d’une valeur pour $Null supprime la clé.
La troisième commande définit les valeurs des clés spécifiées dans la table de hachage.
La dernière commande lit les paires clé/valeur pour la machine virtuelle nommée VM01.
Exemple 7 : Supprimer une valeur et définir une autre valeur sur vide
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $ValuesMap4 = @{"VLSM2" = $Null; "VSLM1" = "" }
PS C:\> Set-SCGuestInfo -VM $VM -KVPMap $ValuesMap4
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $ValuesMap4 | Select KVPMapLa première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande crée une table de hachage nommée $ValuesMap 4 qui contient les clés et valeurs correspondantes pour les paires clé/valeur. Les valeurs peuvent être définies sur une chaîne, une chaîne vide ou $Null. La définition d’une valeur pour $Null supprime la clé.
La troisième commande définit les valeurs des clés spécifiées dans la table de hachage.
La quatrième commande supprime la clé VLSM2 et définit la clé VSLM1 sur vide en appelant la commande Set-SCGuestInfo .
La dernière commande lit les paires clé/valeur pour la machine virtuelle nommée VM01.
Exemple 8 : Définir une valeur et supprimer une autre valeur
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $ValuesMap5 = @{"VSLM1" = "data again"; "VLSM3" = $Null }
PS C:\> Set-SCGuestInfo -VM $VM -KVPMap $ValuesMap5
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $ValuesMap5 | Select KVPMapLa première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande crée une table de hachage nommée $ValuesMap 5 qui contient les clés et valeurs correspondantes pour les paires clé/valeur. Les valeurs peuvent être définies sur une chaîne, une chaîne vide ou $Null. La définition d’une valeur pour $Null supprime la clé.
La quatrième commande définit la clé VSLM1 sur « données à nouveau » et supprime la clé VLSM3 en appelant la commande Set-SCGuestInfo .
La dernière commande lit les paires clé/valeur pour la machine virtuelle nommée VM01.
Exemple 9 : Ignorer la suppression de 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:\> Set-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist
PS C:\> Set-SCGuestInfo -VM $VM -Key "o1ff1"La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande crée une table de hachage nommée $ValuesMap 5 qui contient les clés et valeurs correspondantes pour les paires clé/valeur. La définition d’une valeur pour $Null supprime la clé.
La troisième commande définit les valeurs à $Null pour les clés spécifiées dans la table de hachage.
La dernière commande supprime toutes les clés de la table de hachage à l’exception de la clé o1ff1 en appelant l’applet de commande Set-SCGuestInfo .
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 |
-Value
Spécifie une chaîne utilisée pour attribuer un objet ou une propriété.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| 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 .