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
Aliases:ConfigurationArchiveBlob
Position:5
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveContainerName

Nama spesies kontainer penyimpanan Azure tempat arsip konfigurasi berada.

Jenis:String
Aliases:ContainerName
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveStorageAccountName

Menentukan nama akun penyimpanan Azure yang digunakan untuk mengunduh ArchiveBlobName.

Jenis:String
Aliases:StorageAccountName
Position:4
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveStorageEndpointSuffix

Menentukan akhiran titik akhir penyimpanan.

Jenis:String
Aliases:StorageEndpointSuffix
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-ConfigurationArgument

Menentukan tabel hash yang berisi argumen ke fungsi konfigurasi.

Jenis:Hashtable
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationData

Menentukan jalur file .psd1 yang menentukan data untuk konfigurasi.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationName

Menentukan nama konfigurasi yang dipanggil Ekstensi DSC.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Aliases:cf
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Menentukan jalur ekstensi sumber daya.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Menentukan nama grup sumber daya komputer virtual.

Jenis:String
Position:2
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

Menentukan versi ekstensi DSC tempat Set-AzVMDscExtension menerapkan pengaturan.

Jenis:String
Aliases:HandlerVersion
Position:1
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Menentukan nama komputer virtual tempat handler ekstensi DSC diinstal.

Jenis:String
Position:3
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Jenis:SwitchParameter
Aliases:wi
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-WmfVersion

Menentukan versi WMF.

Jenis:String
nilai yang diterima:4.0, 5.0, 5.1, latest
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Hashtable

Output

PSAzureOperationResponse