Bagikan melalui

Add-AzVmssExtension

  • Referensi
Modul:
Az.Compute

Menambahkan ekstensi ke VMSS.

Sintaks

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>]

Deskripsi

Cmdlet Add-AzVmssExtension menambahkan ekstensi ke Virtual Machine Scale Set (VMSS).

Contoh

Contoh 1: Menambahkan ekstensi ke VMSS

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

Perintah ini menambahkan ekstensi ke VMSS.

Contoh 2: Menambahkan ekstensi ke VMSS dengan pengaturan dan pengaturan yang dilindungi

$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

Contoh 3: Menambahkan ekstensi ke VMSS dengan pengaturan dan pengaturan yang dilindungi

$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

Perintah ini menambahkan ekstensi ke VMSS dengan contoh skrip bash pada penyimpanan blob, menentukan url penyimpanan blob dan perintah yang dapat dieksekusi dalam pengaturan dan akses keamanan dalam pengaturan yang dilindungi.

Parameter

-AutoUpgradeMinorVersion

Menunjukkan apakah versi ekstensi harus diperbarui secara otomatis ke versi minor yang lebih baru.

Jenis:Nullable<T>[Boolean]
Position:5
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EnableAutomaticUpgrade

Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia.

Jenis:Nullable<T>[Boolean]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ForceUpdateTag

Jika nilai disediakan dan berbeda dari nilai sebelumnya, handler ekstensi akan dipaksa untuk memperbarui meskipun konfigurasi ekstensi belum berubah.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama ekstensi yang ditambahkan cmdlet ini.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ProtectedSetting

Menentukan konfigurasi privat untuk ekstensi, sebagai string. Cmdlet ini mengenkripsi konfigurasi privat.

Jenis:Object
Position:7
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ProvisionAfterExtension

Kumpulan nama ekstensi setelah ekstensi ini perlu disediakan.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Publisher

Menentukan nama penerbit ekstensi. Penerbit memberikan nama saat penerbit mendaftarkan ekstensi. Ini dapat menggunakan cmdlet Get-AzVMImagePublisher untuk mendapatkan penerbit.

Jenis:String
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Setting

Menentukan konfigurasi publik, sebagai string, untuk ekstensi. Cmdlet ini tidak mengenkripsi konfigurasi publik.

Jenis:Object
Position:6
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Type

Menentukan jenis ekstensi. Anda dapat menggunakan cmdlet Get-AzVMExtensionImageType untuk mendapatkan jenis ekstensi.

Jenis:String
Position:3
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-TypeHandlerVersion

Menentukan versi ekstensi yang akan digunakan untuk komputer virtual ini. Anda dapat menggunakan cmdlet Get-AzVMExtensionImage untuk mendapatkan versi ekstensi.

Jenis:String
Position:4
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-VirtualMachineScaleSet

Tentukan objek VMSS. Anda dapat menggunakan New-AzVmssConfig untuk membuat objek.

Jenis:PSVirtualMachineScaleSet
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

PSVirtualMachineScaleSet

String

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

Object

Output

PSVirtualMachineScaleSet