Set-SCGuestInfo

  • Başvuru
Modül:
VirtualMachineManager

Konuk işletim sistemindeki bir anahtar/değer çifti için anahtarla ilişkili değeri ayarlar.

Syntax

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

Description

Set-SCGuestInfo cmdlet'i, konuk işletim sistemindeki bir anahtar/değer çifti için anahtarla ilişkili değeri ayarlar.

Örnekler

Örnek 1: Tek bir anahtar/değer çifti ayarlama

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

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, VM01 için bir anahtar/değer çifti ayarlar.

Örnek 2: Anahtar/değer çifti için bir değere anahtar ayarlama

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

Bu komut, anahtarı Microsoft.Lab.Isolation.ServerVersion olarak, değeri ise VM01 adlı sanal makine için 1.0.1101 olarak ayarlar. Anahtar yoksa, belirtilen değerle oluşturulur. Anahtar zaten varsa, bu komutta belirtilen değer kullanılarak değerinin üzerine yazılır.

Anahtarı sağlamak ve karşılık gelen değerini döndürmek için Read-SCGuestInfo cmdlet'ini kullanabilirsiniz.

Örnek 3: Birden çok anahtar/değer çifti ayarlama

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

İlk komut Win2k8R2 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, anahtar/değer çiftleri için karşılık gelen anahtarları ve değerleri içeren $ValuesMap adlı bir karma tablo oluşturur. Değerler bir dizeye, boş bir dizeye veya $Null olarak ayarlanabilir. Değeri $Null olarak ayarlamak anahtarı siler.

Üçüncü komut, Win2k8R2 adlı sanal makine için anahtar/değer çiftlerini ayarlar.

Son komut, Win2k8R2 adlı sanal makine için anahtar/değer çiftlerini geri okur.

Örnek 4: Bir dizi anahtar/değer çifti için bir değer kümesini değiştirme

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

İlk komut Win2k8R2 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, anahtar/değer çiftleri için karşılık gelen anahtarları ve değerleri içeren $ValuesMap adlı bir karma tablo oluşturur. Değerler bir dizeye, boş bir dizeye veya $Null olarak ayarlanabilir. Değeri $Null olarak ayarlamak anahtarı siler.

Üçüncü komut, Win2k8R2 adlı sanal makine için anahtar/değer çiftlerini ayarlar.

Dördüncü komut, Win2k8R2 adlı sanal makine için anahtar/değer çiftlerini geri okur.

Beşinci komut, belirli bir anahtarın farklı bir değere değiştirildiği yeni bir karma tablo oluşturur.

Altıncı komut, karma tablodaki belirtilen anahtar için değiştirilmiş değeri ayarlar.

Son iki komut, Anahtar2IsEmptyString anahtarının değiştirilmiş değeri de dahil olmak üzere Win2k8R2 adlı sanal makine için anahtar/değer çiftlerini okur.

Örnek 5: İki yöntem kullanarak anahtar/değer çifti silme

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

İlk komut Win2k8R2 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

Sonraki üç komut iki anahtar ve değerlerini oluşturur ve bunları Win2k8R2 sanal makinesi konsoluna döndürür.

Beşinci komut, değer parametresini belirtmeden Set-SCGuestInfo çağrısı yaparak Anahtar1 anahtar/değer çiftini siler.

Altıncı ve yedinci komutlar, Key2 anahtarı için null değer içeren yeni bir Hashtable oluşturur. Ardından Anahtar2 anahtarı Set-SCGuestInfo cmdlet'i çağrılarak silinir.

Son komut, başlangıçta oluşturulan her iki anahtarın da artık iki ayrı yöntemle silindiğini gösterir.

Örnek 6: Bir değerin boş olduğu birden çok değer ayarlama

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

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, anahtar/değer çiftleri için karşılık gelen anahtarları ve değerleri içeren $ValuesMap 3 adlı bir karma tablo oluşturur. Değerler bir dizeye, boş bir dizeye veya $Null olarak ayarlanabilir. Değeri $Null olarak ayarlamak anahtarı siler.

Üçüncü komut, karma tablodaki belirtilen anahtarların değerlerini ayarlar.

Son komut, VM01 adlı sanal makine için anahtar/değer çiftlerini geri okur.

Örnek 7: Bir değeri silme ve başka bir değeri boş olarak ayarlama

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

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, anahtar/değer çiftleri için karşılık gelen anahtarları ve değerleri içeren $ValuesMap 4 adlı bir karma tablo oluşturur. Değerler bir dizeye, boş bir dizeye veya $Null olarak ayarlanabilir. Değeri $Null olarak ayarlamak anahtarı siler.

Üçüncü komut, karma tablodaki belirtilen anahtarların değerlerini ayarlar.

Dördüncü komut anahtar VLSM2'yi siler ve Set-SCGuestInfo komutunu çağırarak VSLM1 anahtarını boş olarak ayarlar.

Son komut, VM01 adlı sanal makine için anahtar/değer çiftlerini geri okur.

Örnek 8: Bir değer ayarlama ve başka bir değeri silme

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

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, anahtar/değer çiftleri için karşılık gelen anahtarları ve değerleri içeren $ValuesMap 5 adlı bir karma tablo oluşturur. Değerler bir dizeye, boş bir dizeye veya $Null olarak ayarlanabilir. Değeri $Null olarak ayarlamak anahtarı siler.

Dördüncü komut, ANAHTAR VSLM1'i "yeniden veri" olarak ayarlar ve Set-SCGuestInfo komutunu çağırarak anahtar VLSM3'ünü siler.

Son komut, VM01 adlı sanal makine için anahtar/değer çiftlerini geri okur.

Örnek 9: Var olmayan anahtarların silinmesini yoksayma

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"

İlk komut VM01 adlı sanal makine nesnesini alır ve nesneyi $VM değişkeninde depolar.

İkinci komut, anahtar/değer çiftleri için karşılık gelen anahtarları ve değerleri içeren $ValuesMap 5 adlı bir karma tablo oluşturur. Değeri $Null olarak ayarlamak anahtarı siler.

Üçüncü komut, değerleri karma tablodaki belirtilen anahtarlar için $Null olarak ayarlar.

Son komut, Set-SCGuestInfo cmdlet'ini çağırarak o1ff1 anahtarı dışındaki karma tablodaki tüm anahtarları siler.

Parametreler

-Key

Anahtarı bir anahtar/değer çiftinde belirtir.

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

-KvpMap

Hyper-V tarafından kullanıma sunulan değerlere karşılık gelen anahtar/değer çiftlerinin karma tablosunu belirtir.

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

-Value

Bir nesne veya özelliğin özniteliğini oluşturmak için kullanılan dizeyi belirtir.

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

-VM

Bir sanal makine nesnesi belirtir.

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

Çıkışlar

String

Bu cmdlet bir String nesnesi döndürür.