Set-AzVMExtension

  • Başvuru
Modül:
Az.Compute

uzantı özelliklerini Güncelleştirmeler veya bir sanal makineye uzantı ekler.

Syntax

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ı $Ayarlar ve $Protected Ayarlar 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 içindeki VirtualMachine22 adlı sanal makinenin uzantısını $ Ayarlar ve $Protected Ayarlar 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ı $Ayarlar String ve $Protected Ayarlar String değişkenlerinde depolar. Son komut, ResourceGroup11'de VirtualMachine22 adlı sanal makinenin uzantısını $Ayarlar String ve $Protected Ayarlar String içeriklerine 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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionType

Uzantı türünü belirtir.

Type:String
Aliases:Type
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Location

Sanal makinenin konumunu belirtir.

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

-Name

Uzantının adını belirtir.

Type:String
Aliases:ExtensionName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-ProtectedSettings

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

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

-ProtectedSettingString

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

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

-Publisher

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

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

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

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

-Settings

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

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

-SettingString

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

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

-TypeHandlerVersion

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

Type:String
Aliases:HandlerVersion, Version
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

Hashtable

SwitchParameter

Çıkışlar

PSAzureOperationResponse