Add-AzVmssExtension

  • Başvuru
Modül:
Az.Compute

VMSS'ye bir uzantı ekler.

Sözdizimi

Add-AzVmssExtension
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-Name] <String>]
   [[-Publisher] <String>]
   [[-Type] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [[-Setting] <Object>]
   [[-ProtectedSetting] <Object>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-ForceUpdateTag <String>]
   [-ProvisionAfterExtension <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Add-AzVmssExtension cmdlet'i, Sanal Makine Ölçek Kümesi'ne (VMSS) bir uzantı ekler.

Örnekler

Örnek 1: VMSS'ye uzantı ekleme

Add-AzVmssExtension -VirtualMachineScaleSet $VMSS -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True

Bu komut VMSS'ye bir uzantı ekler.

Örnek 2: AYARLAR ve korumalı ayarlarla VMSS'ye uzantı ekleme

$Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
$ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};

Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name $vmssExtensionName -Publisher $vmssPublisher  `
  -Type $vmssExtensionType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True  `
  -Setting $Settings -ProtectedSetting $ProtectedSettings

Örnek 3: VMSS'ye ayarlar ve korumalı ayarlarla uzantı ekleme

$BatchFile = "runbook.sh"
$ResourceGroupName = "HelloRG"
$VMScaleSetName = "HelloVmSS"
$TypeHandlerVersion = 2.1

#Best Practice for securd paramaters.
$protectedSettings = @{
"managedIdentity" = @{ "clientId" = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"};
}

$publicSettings = @{ 
"fileUris"= (,"https://storage.blob.core.windows.net/itfiles/$($BatchFile)");
"commandToExecute"= "sh $($BatchFile)"
}

# Get information about the scale set
$vmss = Get-AzVmss `
            -ResourceGroupName $ResourceGroupName `
            -VMScaleSetName $VMScaleSetName

Add-AzVmssExtension -VirtualMachineScaleSet $vmss `
    -Name "CustomScript" `
    -Publisher "Microsoft.Azure.Extensions" `
    -Type "CustomScript" `
    -TypeHandlerVersion $TypeHandlerVersion `
    -AutoUpgradeMinorVersion $true `
    -Setting $publicSettings `
    -ProtectedSetting $protectedSettings

Update-AzVmss `
    -ResourceGroupName $ResourceGroupName `
    -Name $VMScaleSetName `
    -VirtualMachineScaleSet $vmss

Bu komut, blob depolamada örnek bash betiğiyle VMSS'ye bir uzantı ekler, ayarlarda blob depolama url'sini ve yürütülebilir komutu, korumalı ayarlarda ise güvenlik erişimini belirtin.

Parametreler

-AutoUpgradeMinorVersion

Uzantı sürümünün otomatik olarak daha yeni bir ikincil sürüme güncelleştirilip güncelleştirilmeyeceğini gösterir.

Tür:Nullable<T>[Boolean]
Position:5
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
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:None
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

-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

-ForceUpdateTag

Bir değer sağlanırsa ve önceki değerden farklıysa, uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisi güncelleştirmeye zorlanır.

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

-Name

Bu cmdlet'in eklediği uzantının adını belirtir.

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

-ProtectedSetting

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

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

-ProvisionAfterExtension

Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.

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. Bu, yayımcıyı almak için Get-AzVMImagePublisher cmdlet'ini kullanabilir.

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

-Setting

Uzantı için genel yapılandırmayı dize olarak belirtir. Bu cmdlet genel yapılandırmayı şifrelemez.

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

-Type

Uzantı türünü belirtir. Uzantı türünü almak için Get-AzVMExtensionImageType cmdlet'ini kullanabilirsiniz.

Tür:String
Position:3
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. Uzantının sürümünü almak için Get-AzVMExtensionImage cmdlet'ini kullanabilirsiniz.

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

-VirtualMachineScaleSet

VMSS nesnesini belirtin. Nesneyi oluşturmak için New-AzVmssConfig kullanabilirsiniz.

Tür:PSVirtualMachineScaleSet
Position:0
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:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Object

Çıkışlar

PSVirtualMachineScaleSet