Megosztás a következőn keresztül:

Set-SCGuestInfo

  • Referencia
Modul:
VirtualMachineManager

Beállítja a vendég operációs rendszerben lévő kulcs/érték pár kulcsához társított értéket.

Syntax

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

Description

A Set-SCGuestInfo parancsmag beállítja a vendég operációs rendszerben lévő kulcs/érték pár kulcsához társított értéket.

Példák

1. példa: Egyetlen kulcs/érték pár beállítása

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

Az első parancs lekéri a VM01 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs beállít egy kulcs/érték párt a VM01-hez.

2. példa: Kulcs beállítása egy kulcs/érték pár értékére

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

Ez a parancs a kulcsot a Microsoft.Lab.Isolation.ServerVersion értékre állítja, az értéket pedig a VM01 nevű virtuális gép 1.0.1101-ére. Ha a kulcs nem létezik, a rendszer a megadott értékkel hozza létre. Ha a kulcs már létezik, a rendszer felülírja az értékét az ebben a parancsban megadott értékkel.

A Read-SCGuestInfo parancsmaggal megadhatja a kulcsot, és visszaadhatja annak megfelelő értékét.

3. példa: Több kulcs/érték pár beállítása

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

Az első parancs lekéri a Win2k8R2 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs létrehoz egy $ValuesMap nevű kivonattáblát, amely tartalmazza a kulcs/érték párok megfelelő kulcsait és értékeit. Az értékek beállíthatók sztringre, üres sztringre vagy $Null. Ha $Null értéket állít be, törli a kulcsot.

A harmadik parancs beállítja a Win2k8R2 nevű virtuális gép kulcs-érték párjait.

Az utolsó parancs visszaolvassa a Win2k8R2 nevű virtuális gép kulcs-érték párjait.

4. példa: Kulcs-érték párok értékkészletének módosítása

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

Az első parancs lekéri a Win2k8R2 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs létrehoz egy $ValuesMap nevű kivonattáblát, amely tartalmazza a kulcs/érték párok megfelelő kulcsait és értékeit. Az értékek beállíthatók sztringre, üres sztringre vagy $Null. Ha $Null értéket állít be, törli a kulcsot.

A harmadik parancs beállítja a Win2k8R2 nevű virtuális gép kulcs-érték párjait.

A negyedik parancs visszaolvassa a Win2k8R2 nevű virtuális gép kulcs-érték párjait.

Az ötödik parancs létrehoz egy új kivonattáblát, amelyben egy adott kulcs egy másik értékre módosul.

A hatodik parancs beállítja a kivonattáblában megadott kulcs módosított értékét.

Az utolsó két parancs visszaolvassa a Win2k8R2 nevű virtuális gép kulcs-érték párjait, beleértve a Key2IsEmptyString kulcs módosított értékét is.

5. példa: Kulcs/érték pár törlése két módszerrel

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

Az első parancs lekéri a Win2k8R2 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A következő három parancs két kulcsot és azok értékeit hozza létre, és visszaadja őket a Win2k8R2 virtuális gép konzoljára.

Az ötödik parancs a Set-SCGuestInfo meghívásával törli a Key1 kulcs/érték párot az értékparaméter megadása nélkül.

A hatodik és hetedik parancs létrehoz egy új kivonattáblát, amelynek értéke Null lesz a Key2 kulcs értékeként. Ezután a Set-SCGuestInfo parancsmag meghívásával a 2. kulcs törlődik.

Az utolsó parancs azt mutatja, hogy az eredetileg létrehozott két kulcs két külön módszerrel törlődik.

6. példa: Több érték beállítása, ha egy érték üres

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

Az első parancs lekéri a VM01 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs létrehoz egy $ValuesMap 3 nevű kivonattáblát, amely tartalmazza a kulcs/érték párok megfelelő kulcsait és értékeit. Az értékek beállíthatók sztringre, üres sztringre vagy $Null. Ha $Null értéket állít be, törli a kulcsot.

A harmadik parancs beállítja a kivonattáblában megadott kulcsok értékeit.

Az utolsó parancs visszaolvassa a VM01 nevű virtuális gép kulcs-érték párjait.

7. példa: Egy érték törlése és egy másik érték beállítása üresre

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

Az első parancs lekéri a VM01 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs létrehoz egy $ValuesMap 4 nevű kivonattáblát, amely tartalmazza a kulcs/érték párok megfelelő kulcsait és értékeit. Az értékek beállíthatók sztringre, üres sztringre vagy $Null. Ha $Null értéket állít be, törli a kulcsot.

A harmadik parancs beállítja a kivonattáblában megadott kulcsok értékeit.

A negyedik parancs törli a VLSM2 kulcsot, és a Set-SCGuestInfo parancs meghívásával üresre állítja a VSLM1 kulcsot.

Az utolsó parancs visszaolvassa a VM01 nevű virtuális gép kulcs-érték párjait.

8. példa: Egy érték beállítása és egy másik érték törlése

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

Az első parancs lekéri a VM01 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs létrehoz egy $ValuesMap 5 nevű kivonattáblát, amely tartalmazza a kulcs/érték párok megfelelő kulcsait és értékeit. Az értékek beállíthatók sztringre, üres sztringre vagy $Null. Ha $Null értéket állít be, törli a kulcsot.

A negyedik parancs a VSLM1 kulcsot "data again" értékre állítja, és a Set-SCGuestInfo parancs meghívásával törli a VLSM3 kulcsot.

Az utolsó parancs visszaolvassa a VM01 nevű virtuális gép kulcs-érték párjait.

9. példa: A nem létező kulcsok törlésének figyelmen kívül hagyása

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"

Az első parancs lekéri a VM01 nevű virtuálisgép-objektumot, és az objektumot a $VM változóban tárolja.

A második parancs létrehoz egy $ValuesMap 5 nevű kivonattáblát, amely tartalmazza a kulcs/érték párok megfelelő kulcsait és értékeit. Ha $Null értéket állít be, törli a kulcsot.

A harmadik parancs a kivonattáblában megadott kulcsokhoz $Null értékeket állítja be.

Az utolsó parancs törli a kivonattábla összes kulcsát az o1ff1 billentyű kivételével a Set-SCGuestInfo parancsmag meghívásával.

Paraméterek

-Key

Kulcs/érték párban adja meg a kulcsot.

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

-KvpMap

A Hyper-V által közzétett értékeknek megfelelő kulcs-érték párok kivonattábláját adja meg.

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

-Value

Egy objektum vagy tulajdonság attribútumához használt sztringet határoz meg.

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

-VM

Egy virtuálisgép-objektumot határoz meg.

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

Kimenetek

String

Ez a parancsmag sztringobjektumot ad vissza.