Set-AzVMExtension

  • Başvuru
Modül:
Az.Compute

Uzantı özelliklerini güncelleştirir veya bir sanal makineye uzantı ekler.

Sözdizimi

Set-AzVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-Settings <Hashtable>]
   [-ProtectedSettings <Hashtable>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-SettingString <String>]
   [-ProtectedSettingString <String>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzVMExtension cmdlet'i mevcut Sanal Makine Uzantılarının özelliklerini güncelleştirir veya bir sanal makineye uzantı ekler.

Örnekler

Örnek 1: Karma tabloları kullanarak ayarları değiştirme

$Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
$ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -ExtensionType "CustomScriptExtension" -TypeHandlerVersion "1.1" -Settings $Settings -ProtectedSettings $ProtectedSettings;

İlk iki komut, karma tablolar oluşturmak için standart Windows PowerShell söz dizimini kullanır ve ardından bu karma tabloları $Settings ve $ProtectedSettings değişkenlerinde depolar. Daha fazla bilgi için yazın Get-Help about_Hash_Tables. İkinci komut, daha önce oluşturulmuş ve değişkenlerde depolanan iki değeri içerir. Son komut, ResourceGroup11'de VirtualMachine22 adlı sanal makinenin uzantısını $Settings ve $ProtectedSettings içeriğine göre değiştirir. komutu, yayımcıyı ve uzantı türünü içeren diğer gerekli bilgileri belirtir.

Örnek 2: Dizeleri kullanarak ayarları değiştirme

$SettingsString = '{"fileUris":[],"commandToExecute":""}';
$ProtectedSettingsString = '{"storageAccountName":"' + $stoname + '","storageAccountKey":"' + $stokey + '"}';
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "CustomScriptExtension" -Publisher "Contoso.Compute" -ExtensionType "CustomScriptExtension" -TypeHandlerVersion "1.1" -SettingString $SettingsString -ProtectedSettingString $ProtectedSettingsString ;

İlk iki komut, ayarları içeren dizeler oluşturur ve bunları $SettingsString ve $ProtectedSettingsString değişkenlerinde depolar. Son komut, ResourceGroup11'de VirtualMachine22 adlı sanal makinenin uzantısını $SettingsString ve $ProtectedSettingsString içeriğine göre değiştirir. komutu, yayımcıyı ve uzantı türünü içeren diğer gerekli bilgileri belirtir.

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DisableAutoUpgradeMinorVersion

Bu cmdlet'in Azure konuk aracısının uzantıları otomatik olarak daha yeni bir ikincil sürüme güncelleştirmesini önlediğini gösterir. Varsayılan olarak, bu cmdlet konuk aracısının uzantıları güncelleştirmesini sağlar.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EnableAutomaticUpgrade

Kullanılabilir uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ExtensionType

Uzantı türünü belirtir.

Tür:String
Diğer adlar:Type
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ForceRerun

Bu cmdlet'in, uzantıyı kaldırıp yeniden yüklemeden sanal makinede aynı uzantı yapılandırmasının yeniden çalıştırılmasını zorladığını gösterir. Değer, geçerli değerden farklı herhangi bir dize olabilir. forceUpdateTag değiştirilmezse, ortak veya korumalı ayarlara yapılan güncelleştirmeler işleyici tarafından uygulanmaya devam eder.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Location

Sanal makinenin konumunu belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Uzantının adını belirtir.

Tür:String
Diğer adlar:ExtensionName
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-NoWait

İşlemi başlatır ve işlem tamamlanmadan hemen önce döndürür. İşlemin başarıyla tamamlandığını belirlemek için başka bir mekanizma kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProtectedSettings

Uzantının özel yapılandırmasını karma tablo olarak belirtir. Bu cmdlet özel yapılandırmayı şifreler.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ProtectedSettingString

Uzantının özel yapılandırmasını dize olarak belirtir. Bu cmdlet özel yapılandırmayı şifreler.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Publisher

Uzantı yayımcısının adını belirtir. Yayımcı bir uzantı kaydettirdiğinde yayımcı bir ad sağlar.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Settings

Uzantının genel yapılandırmasını karma tablo olarak belirtir. Bu cmdlet genel yapılandırmayı şifrelemez.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SettingString

Uzantının genel yapılandırmasını dize olarak belirtir. Bu cmdlet genel yapılandırmayı şifrelemez.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-TypeHandlerVersion

Bu sanal makine için kullanılacak uzantının sürümünü belirtir.

Tür:String
Diğer adlar:HandlerVersion, Version
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-VMName

Sanal makinenin adını belirtir. Bu cmdlet, bu parametrenin belirttiği sanal makinenin uzantılarını değiştirir.

Tür:String
Diğer adlar:ResourceName
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Hashtable

SwitchParameter

Çıkışlar

PSAzureOperationResponse