Set-SCGuestInfo
Définit la valeur associée à une clé pour une paire clé/valeur dans un système d’exploitation invité.
Syntaxe
Set-SCGuestInfo
[-VM] <VM>
-KvpMap <Hashtable>
[<CommonParameters>] Set-SCGuestInfo
[-VM] <VM>
[-Key] <String>
[[-Value] <String>]
[<CommonParameters>] Description
La cmdlet 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 sur $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 de 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 sur $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 modifiée en une autre valeur.
La sixième commande définit la valeur modifiée de 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 pour 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 pour la machine virtuelle Win2k8R2.
La cinquième commande supprime la paire clé/valeur Key1 en appelant Set-SCGuestInfo sans spécifier le paramètre valeur.
Les sixième et septième commandes créent une table de hachage avec Null comme valeur de clé Key2. Ensuite, key Key2 est supprimée en appelant l’applet de commande Set-SCGuestInfo.
La dernière commande indique que les deux clés créées initialement 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 sur $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 sur $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 sur $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 sur $Null supprime la clé.
La troisième commande définit les valeurs sur $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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-KvpMap
Spécifie une table de hachage de paires clé/valeur correspondant aux valeurs exposées par Hyper-V.
| Type: | Hashtable |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Value
Spécifie une chaîne utilisée pour attribuer un objet ou une propriété.
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VM
Spécifie un objet de machine virtuelle.
| Type: | VM |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Sorties
String
Cette applet de commande retourne un objet String.