Sdílet prostřednictvím

Set-SCGuestInfo

  • Reference
Modul:
VirtualMachineManager

Nastaví hodnotu přidruženou k klíči páru klíč/hodnota v hostovaném operačním systému.

Syntax

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

Description

Rutina Set-SCGuestInfo nastaví hodnotu přidruženou ke klíči páru klíč/hodnota v hostovaném operačním systému.

Příklady

Příklad 1: Nastavení páru jeden klíč/hodnota

PS C:\> $VM = Get-SCVirtualMachine "VM01" 
PS C:\> Set-SCGuestInfo -VM $VM -Key Key -Value Value

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží objekt do proměnné $VM.

Druhý příkaz nastaví dvojici klíč/hodnota pro VM01.

Příklad 2: Nastavení klíče na hodnotu páru klíč/hodnota

PS C:\> Get-SCVirtualMachine -Name "VM01" | Set-SCGuestInfo -Key Microsoft.Lab.Isolation.ServerVersion -Value 1.0.1101

Tento příkaz nastaví klíč na Microsoft.Lab.Isolation.ServerVersion a hodnotu na 1.0.1101 pro virtuální počítač s názvem VM01. Pokud klíč neexistuje, vytvoří se se zadanou hodnotou. Pokud klíč již existuje, jeho hodnota se přepíše pomocí hodnoty zadané v tomto příkazu.

Pomocí rutiny Read-SCGuestInfo můžete zadat klíč a vrátit odpovídající hodnotu.

Příklad 3: Nastavení několika párů klíč/hodnota

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

První příkaz získá objekt virtuálního počítače s názvem Win2k8R2 a uloží objekt do proměnné $VM.

Druhý příkaz vytvoří hashovací tabulku s názvem $ValuesMap, která obsahuje odpovídající klíče a hodnoty párů klíč/hodnota. Hodnoty lze nastavit na řetězec, prázdný řetězec nebo $Null. Nastavení hodnoty pro $Null klíč odstraní.

Třetí příkaz nastaví páry klíč/hodnota pro virtuální počítač s názvem Win2k8R2.

Poslední příkaz načte páry klíč/hodnota pro virtuální počítač s názvem Win2k8R2.

Příklad 4: Úprava sady hodnot pro sadu párů klíč/hodnota

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 KvpMap

První příkaz získá objekt virtuálního počítače s názvem Win2k8R2 a uloží objekt do proměnné $VM.

Druhý příkaz vytvoří hashovací tabulku s názvem $ValuesMap, která obsahuje odpovídající klíče a hodnoty párů klíč/hodnota. Hodnoty lze nastavit na řetězec, prázdný řetězec nebo $Null. Nastavení hodnoty pro $Null klíč odstraní.

Třetí příkaz nastaví páry klíč/hodnota pro virtuální počítač s názvem Win2k8R2.

Čtvrtý příkaz přečte páry klíč/hodnota pro virtuální počítač s názvem Win2k8R2.

Pátý příkaz vytvoří novou hashtable, kde se konkrétní klíč změní na jinou hodnotu.

Šestý příkaz nastaví upravenou hodnotu pro zadaný klíč v hashtable.

Poslední dva příkazy přečtou páry klíč/hodnota pro virtuální počítač s názvem Win2k8R2, včetně modifiied hodnoty pro klíč Key2IsEmptyString.

Příklad 5: Odstranění páru klíč/hodnota pomocí dvou metod

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 KvpMap

První příkaz získá objekt virtuálního počítače s názvem Win2k8R2 a uloží objekt do proměnné $VM.

Následující tři příkazy vytvoří dva klíče a jejich hodnoty a vrátí je do konzoly pro virtuální počítač Win2k8R2.

Pátý příkaz odstraní pár klíč/hodnota Key1 voláním Set-SCGuestInfo bez zadání parametru hodnoty.

Šestý a sedmý příkaz vytvoří novou hashtable s hodnotou Null jako hodnotu klíče Key2. Potom klíč Key2 odstraníte voláním rutiny Set-SCGuestInfo .

Poslední příkaz ukazuje, že oba klíče, které byly původně vytvořeny, jsou nyní odstraněny pomocí dvou samostatných metod.

Příklad 6: Nastavení více hodnot, ve kterých je jedna hodnota prázdná

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 KVPMap

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží objekt do proměnné $VM.

Druhý příkaz vytvoří hashtable s názvem $ValuesMap 3, který obsahuje odpovídající klíče a hodnoty párů klíč/hodnota. Hodnoty lze nastavit na řetězec, prázdný řetězec nebo $Null. Nastavení hodnoty pro $Null klíč odstraní.

Třetí příkaz nastaví hodnoty pro zadané klíče v hashtable.

Poslední příkaz načte páry klíč/hodnota pro virtuální počítač s názvem VM01.

Příklad 7: Odstraňte jednu hodnotu a nastavte jinou hodnotu na prázdnou.

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 KVPMap

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží objekt do proměnné $VM.

Druhý příkaz vytvoří hashtable s názvem $ValuesMap 4, který obsahuje odpovídající klíče a hodnoty pro páry klíč/hodnota. Hodnoty lze nastavit na řetězec, prázdný řetězec nebo $Null. Nastavení hodnoty pro $Null klíč odstraní.

Třetí příkaz nastaví hodnoty pro zadané klíče v hashtable.

Čtvrtý příkaz odstraní klíč VLSM2 a nastaví klíč VSLM1 na prázdný voláním příkazu Set-SCGuestInfo .

Poslední příkaz načte páry klíč/hodnota pro virtuální počítač s názvem VM01.

Příklad 8: Nastavení jedné hodnoty a odstranění jiné hodnoty

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 KVPMap

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží objekt do proměnné $VM.

Druhý příkaz vytvoří hashtable s názvem $ValuesMap 5, který obsahuje odpovídající klíče a hodnoty párů klíč/hodnota. Hodnoty lze nastavit na řetězec, prázdný řetězec nebo $Null. Nastavení hodnoty pro $Null klíč odstraní.

Čtvrtý příkaz nastaví klíč VSLM1 na "data znovu" a odstraní klíč VLSM3 voláním příkazu Set-SCGuestInfo .

Poslední příkaz načte páry klíč/hodnota pro virtuální počítač s názvem VM01.

Příklad 9: Ignorovat odstranění klíčů, které neexistují

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"

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží objekt do proměnné $VM.

Druhý příkaz vytvoří hashtable s názvem $ValuesMap 5, který obsahuje odpovídající klíče a hodnoty párů klíč/hodnota. Nastavení hodnoty pro $Null klíč odstraní.

Třetí příkaz nastaví hodnoty na $Null pro zadané klíče v hashtable.

Poslední příkaz odstraní všechny klíče v hashtable s výjimkou klíče o1ff1 voláním rutiny Set-SCGuestInfo .

Parametry

-Key

Určuje klíč v páru klíč/hodnota.

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

-KvpMap

Určuje tabulku hash párů klíč/hodnota odpovídající hodnotám vystaveným technologií Hyper-V.

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

-Value

Určuje řetězec použitý k atributu objektu nebo vlastnosti.

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

-VM

Určuje objekt virtuálního počítače.

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

Výstupy

String

Tato rutina vrátí objekt String .