Set-AzureRmVMExtension

Referensi

Modul:: AzureRM.Compute

Updates properti ekstensi atau menambahkan ekstensi ke komputer virtual.

Penting

Karena modul Az PowerShell sekarang memiliki semua kemampuan modul AzureRM PowerShell dan lebih banyak lagi, kami akan menghentikan modul AzureRM PowerShell pada 29 Februari 2024.

Untuk menghindari gangguan layanan, perbarui skrip Anda yang menggunakan modul AzureRM PowerShell untuk menggunakan modul Az PowerShell paling lambat 29 Februari 2024. Untuk memperbarui skrip Anda secara otomatis, ikuti panduan memulai cepat.

Sintaks

Set-AzureRmVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-Settings <Hashtable>]
   [-ProtectedSettings <Hashtable>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-SettingString <String>]
   [-ProtectedSettingString <String>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzureRmVMExtension memperbarui properti untuk Ekstensi Komputer Virtual yang ada atau menambahkan ekstensi ke komputer virtual.

Contoh

Contoh 1: Mengubah pengaturan dengan menggunakan tabel hash

PS C:\> $Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
PS C:\> $ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
PS C:\> Set-AzureRmVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -Type "CustomScriptExtension" -TypeHandlerVersion "1.1" -Settings $Settings -ProtectedSettings $ProtectedSettings;

Dua perintah pertama menggunakan sintaks Windows PowerShell standar untuk membuat tabel hash, lalu menyimpan tabel hash tersebut dalam variabel $Settings dan $ProtectedSettings. Untuk informasi selengkapnya, ketik Get-Help about_Hash_Tables. Perintah kedua mencakup dua nilai yang sebelumnya dibuat dan disimpan dalam variabel. Perintah akhir memodifikasi ekstensi komputer virtual bernama VirtualMachine22 di ResourceGroup11 sesuai dengan konten $Settings dan $ProtectedSettings. Perintah menentukan informasi lain yang diperlukan yang mencakup penerbit dan jenis ekstensi.

Contoh 2: Mengubah pengaturan dengan menggunakan string

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

Dua perintah pertama membuat string yang berisi pengaturan, lalu menyimpannya dalam variabel $SettingsString dan $ProtectedSettingsString. Perintah akhir memodifikasi ekstensi komputer virtual bernama VirtualMachine22 di ResourceGroup11 sesuai dengan konten $SettingsString dan $ProtectedSettingsString. Perintah menentukan informasi lain yang diperlukan yang mencakup penerbit dan jenis ekstensi.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-DefaultProfile

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

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

-DisableAutoUpgradeMinorVersion

Menunjukkan bahwa cmdlet ini mencegah agen tamu Azure memperbarui ekstensi secara otomatis ke versi minor yang lebih baru. Secara default, cmdlet ini memungkinkan agen tamu memperbarui ekstensi.

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

-ExtensionType

Menentukan jenis ekstensi.

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

-ForceRerun

Menunjukkan bahwa cmdlet ini memaksa pengoperasian ulang konfigurasi ekstensi yang sama pada komputer virtual tanpa menghapus instalasi dan menginstal ulang ekstensi. Nilai dapat berupa string apa pun yang berbeda dari nilai saat ini. Jika forceUpdateTag tidak diubah, pembaruan pada pengaturan publik atau terproteksi masih diterapkan oleh handler.

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

-Location

Menentukan lokasi komputer virtual.

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

-Name

Menentukan nama ekstensi.

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

-ProtectedSettings

Menentukan konfigurasi privat untuk ekstensi, sebagai tabel hash. Cmdlet ini mengenkripsi konfigurasi privat.

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

-ProtectedSettingString

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

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.

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

-ResourceGroupName

Menentukan nama grup sumber daya komputer virtual.

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

-Settings

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

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

-SettingString

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

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

-TypeHandlerVersion

Menentukan versi ekstensi yang akan digunakan untuk komputer virtual ini.

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

-VMName

Menentukan nama komputer virtual. Cmdlet ini memodifikasi ekstensi untuk komputer virtual yang ditentukan parameter ini.

Type:	String
Aliases:	ResourceName
Position:	1
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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

String

Hashtable

SwitchParameter

Output

PSAzureOperationResponse