Set-AzVMDscExtension
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
Output
Link Terkait
Azure PowerShell