Bagikan melalui

Set-AzVMDscExtension

  • Referensi
Modul:
Az.Compute

Mengonfigurasi ekstensi DSC pada komputer virtual.

Sintaks

Set-AzVMDscExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-ArchiveBlobName] <String>
   [-ArchiveStorageAccountName] <String>
   [-ArchiveResourceGroupName <String>]
   [-ArchiveStorageEndpointSuffix <String>]
   [-ArchiveContainerName <String>]
   [-ConfigurationName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationData <String>]
   [-Version] <String>
   [-Force]
   [-Location <String>]
   [-AutoUpdate]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzVMDscExtension mengonfigurasi ekstensi Windows PowerShell Desired State Configuration (DSC) pada komputer virtual dalam grup sumber daya.

Contoh

Contoh 1: Mengatur ekstensi DSC

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Perintah ini mengatur ekstensi DSC pada komputer virtual bernama VM07 untuk mengunduh Sample.ps1.zip dari akun penyimpanan bernama Stg dan kontainer default. Perintah memanggil konfigurasi bernama ConfigName. File Sample.ps1.zip sebelumnya diunggah dengan menggunakan Publish-AzVMDscConfiguration.

Contoh 2: Mengatur ekstensi DSC dengan data konfigurasi

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"

Perintah ini mengatur ekstensi pada komputer virtual bernama VM13 untuk mengunduh Sample.ps1.zip dari akun penyimpanan bernama Stg dan kontainer bernama WindowsPowerShellDSC. Perintah konfigurasi bernama ConfigName dan menentukan data konfigurasi dan argumen. File Sample.ps1.zip sebelumnya diunggah dengan menggunakan Publish-AzVMDscConfiguration.

Contoh 3: Mengatur ekstensi DSC dengan data konfigurasi yang memiliki pembaruan otomatis

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate

Perintah ini mengatur ekstensi pada komputer virtual bernama VM22 untuk mengunduh Sample.ps1.zip dari akun penyimpanan bernama Stg dan kontainer bernama WindowsPowerShellDSC. Perintah memanggil konfigurasi bernama ConfigName dan menentukan data konfigurasi dan argumen. Perintah ini juga memungkinkan pembaruan otomatis handler ekstensi ke versi terbaru. Sample.ps1.zip sebelumnya diunggah dengan menggunakan Publish-AzVMDscConfiguration.

Parameter

-ArchiveBlobName

Menentukan nama file konfigurasi yang sebelumnya diunggah oleh cmdlet Publish-AzVMDscConfiguration.

Jenis:String
Alias:ConfigurationArchiveBlob
Position:5
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ArchiveContainerName

Nama spesies kontainer penyimpanan Azure tempat arsip konfigurasi berada.

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

-ArchiveResourceGroupName

Menentukan nama grup sumber daya yang berisi akun penyimpanan yang berisi arsip konfigurasi. Parameter ini bersifat opsional jika akun penyimpanan dan komputer virtual keduanya berada dalam grup sumber daya yang sama.

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

-ArchiveStorageAccountName

Menentukan nama akun penyimpanan Azure yang digunakan untuk mengunduh ArchiveBlobName.

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

-ArchiveStorageEndpointSuffix

Menentukan akhiran titik akhir penyimpanan.

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

-AutoUpdate

Menentukan versi handler ekstensi yang ditentukan oleh parameter Versi . Secara default, handler ekstensi tidak diupdasi otomatis. Gunakan parameter AutoUpdate untuk mengaktifkan pembaruan otomatis handler ekstensi ke versi terbaru sebagai dan kapan tersedia.

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

-ConfigurationArgument

Menentukan tabel hash yang berisi argumen ke fungsi konfigurasi.

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

-ConfigurationData

Menentukan jalur file .psd1 yang menentukan data untuk konfigurasi.

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

-ConfigurationName

Menentukan nama konfigurasi yang dipanggil Ekstensi DSC.

Jenis:String
Position:Named
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:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DataCollection

Menentukan jenis pengumpulan data. Nilai yang dapat diterima untuk parameter ini adalah: Aktifkan dan Nonaktifkan.

Jenis:String
Nilai yang diterima:Enable, Disable
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
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

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

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

-Location

Menentukan jalur ekstensi sumber daya.

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

-Name

Menentukan nama sumber daya Azure Resource Manager yang mewakili ekstensi. Nilai defaultnya adalah Microsoft.Powershell.DSC.

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

-NoWait

Memulai operasi dan segera kembali, sebelum operasi selesai. Untuk menentukan apakah operasi telah berhasil diselesaikan, gunakan beberapa mekanisme lain.

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

-ResourceGroupName

Menentukan nama grup sumber daya komputer virtual.

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

-Version

Menentukan versi ekstensi DSC tempat Set-AzVMDscExtension menerapkan pengaturan.

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

-VMName

Menentukan nama komputer virtual tempat handler ekstensi DSC diinstal.

Jenis:String
Position:3
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:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WmfVersion

Menentukan versi WMF.

Jenis:String
Nilai yang diterima:4.0, 5.0, 5.1, latest
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

Input

String

Hashtable

Output

PSAzureOperationResponse