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 di pengaturan dan akses keamanan dalam pengaturan yang dilindungi.

Parameter

-AutoUpgradeMinorVersion

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

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpgrade

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

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

-ForceUpdateTag

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

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

-Name

Menentukan nama ekstensi yang ditambahkan cmdlet ini.

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

-ProtectedSetting

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

Type:	Object
Position:	7
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ProvisionAfterExtension

Kumpulan nama ekstensi setelah itu ekstensi ini perlu disediakan.

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

-Publisher

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

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

-Setting

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

Type:	Object
Position:	6
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Type

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

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

-TypeHandlerVersion

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

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

-VirtualMachineScaleSet

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

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

-WhatIf

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

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

Input

PSVirtualMachineScaleSet

String

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

Object

Output