Set-AzVMDscExtension
Mengonfigurasi ekstensi DSC pada komputer virtual.
Sintaks
Default (Default)
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 Desired State Configuration PowerShell (DSC) Windows 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.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False Alias: ConfigurationArchiveBlob
Kumpulan parameter
(All)
Position: 5 Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-ArchiveContainerName
Nama spesies kontainer penyimpanan Azure tempat arsip konfigurasi berada.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False Alias: ContainerName
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-ArchiveStorageAccountName
Menentukan nama akun penyimpanan Azure yang digunakan untuk mengunduh ArchiveBlobName.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False Alias: NamaAkunPenyimpanan
Kumpulan parameter
(All)
Position: 4 Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-ArchiveStorageEndpointSuffix
Menentukan akhiran titik akhir penyimpanan.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False Alias: StorageEndpointSuffix
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: SwitchParameter
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-ConfigurationArgument
Menentukan tabel hash yang berisi argumen ke fungsi konfigurasi.
Properti parameter
Jenis: Hashtable
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-ConfigurationData
Menentukan jalur file .psd1 yang menentukan data untuk konfigurasi.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-ConfigurationName
Menentukan nama konfigurasi yang dipanggil Ekstensi DSC.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
Jenis: SwitchParameter
Nilai default: False Mendukung wildcard: False DontShow: False Alias: Cf
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-DataCollection
Menentukan jenis pengumpulan data.
Nilai yang dapat diterima untuk parameter ini adalah: Aktifkan dan Nonaktifkan.
Properti parameter
Jenis: String
Nilai default: None Nilai yang diterima: Enable, Disable Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.
Properti parameter
Jenis: IAzureContextContainer
Nilai default: None Mendukung wildcard: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-Force
Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.
Properti parameter
Jenis: SwitchParameter
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-Location
Menentukan jalur ekstensi sumber daya.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-Name
Menentukan nama sumber daya Azure Resource Manager yang mewakili ekstensi.
Nilai defaultnya adalah Microsoft. Powershell.DSC.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-NoWait
Memulai operasi dan segera kembali, sebelum operasi selesai. Untuk menentukan apakah operasi telah berhasil diselesaikan, gunakan beberapa mekanisme lain.
Properti parameter
Jenis: SwitchParameter
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-ResourceGroupName
Menentukan nama grup sumber daya komputer virtual.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: 2 Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-Version
Menentukan versi ekstensi DSC yang Set-AzVMDscExtension menerapkan pengaturan.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False Alias: HandlerVersion
Kumpulan parameter
(All)
Position: 1 Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-VMName
Menentukan nama komputer virtual tempat handler ekstensi DSC diinstal.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: 3 Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan.
Cmdlet tidak dijalankan.
Properti parameter
Jenis: SwitchParameter
Nilai default: False Mendukung wildcard: False DontShow: False Alias: wi
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-WmfVersion
Menentukan versi WMF.
Properti parameter
Jenis: String
Nilai default: None Nilai yang diterima: 4.0, 5.0, 5.1, latest Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters .
Output
