共用方式為


Set-AzVMDscExtension

在虛擬機上設定 DSC 擴充功能。

語法

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>]

Description

Set-AzVMDscExtension Cmdlet 會在資源群組中的虛擬機上設定 Windows PowerShell Desired 狀態設定 (DSC) 擴充功能。

範例

範例 1:設定 DSC 擴充功能

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

此命令會在名為 VM07 的虛擬機上設定 DSC 擴充功能,以從名為 Stg 和預設容器的記憶體帳戶下載Sample.ps1.zip。 命令會叫用名為 ConfigName 的組態。 先前已使用 Publish-AzVMDscConfiguration 上傳Sample.ps1.zip檔案

範例 2:使用組態數據設定 DSC 擴充功能

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"

此命令會在名為 VM13 的虛擬機上設定擴充功能,以從名為 Stg 的記憶體帳戶和名為 WindowsPowerShellDSC 的容器下載Sample.ps1.zip。 名為 ConfigName 的組態命令,並指定組態數據和自變數。 先前已使用 Publish-AzVMDscConfiguration 上傳Sample.ps1.zip檔案

範例 3:使用具有自動更新的組態數據設定 DSC 擴充功能

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

此命令會在名為 VM22 的虛擬機上設定擴充功能,以從名為 Stg 的記憶體帳戶和名為 WindowsPowerShellDSC 的容器下載Sample.ps1.zip。 命令會叫用名為 ConfigName 的組態,並指定組態數據和自變數。 此命令也會讓擴充處理程序自動更新至最新版本。 先前已使用 Publish-AzVMDscConfiguration 上傳Sample.ps1.zip。

參數

-ArchiveBlobName

指定先前由 Publish-AzVMDscConfiguration Cmdlet 上傳的組態檔名稱。

類型:String
別名:ConfigurationArchiveBlob
Position:5
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ArchiveContainerName

組態封存所在的 Azure 記憶體容器物種名稱。

類型:String
別名:ContainerName
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ArchiveResourceGroupName

指定資源群組的名稱,其中包含包含組態封存的記憶體帳戶。 如果記憶體帳戶和虛擬機都位於相同的資源群組中,此參數是選擇性的。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ArchiveStorageAccountName

指定用來下載 ArchiveBlobName 的 Azure 記憶體帳戶名稱。

類型:String
別名:StorageAccountName
Position:4
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ArchiveStorageEndpointSuffix

指定記憶體端點後綴。

類型:String
別名:StorageEndpointSuffix
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-AutoUpdate

指定 Version 參數所指定的擴充處理程式版本。 根據預設,擴充處理程式不會自動更新。 使用 AutoUpdate 參數,將擴充處理程式的自動更新為最新版本,以及可用時。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConfigurationArgument

指定哈希表,其中包含組態函式的自變數。

類型:Hashtable
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ConfigurationData

指定 .psd1 檔案的路徑,指定組態的數據。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ConfigurationName

指定 DSC 擴充功能叫用的組態名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DataCollection

指定數據收集類型。 此參數可接受的值為:啟用和停用。

類型:String
接受的值:Enable, Disable
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

強制命令執行,而不要求使用者確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Location

指定資源延伸模組的路徑。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Name

指定代表延伸模組的 Azure Resource Manager 資源名稱。 預設值為 Microsoft.Powershell.DSC。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-NoWait

啟動作業,並在作業完成之前立即傳回。 若要判斷作業是否已順利完成,請使用一些其他機制。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ResourceGroupName

指定虛擬機的資源群組名稱。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Version

指定 Set-AzVMDscExtension 套用設定的 DSC 擴充功能版本。

類型:String
別名:HandlerVersion
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VMName

指定安裝 DSC 擴充處理程式的虛擬機名稱。

類型:String
Position:3
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-WmfVersion

指定 WMF 版本。

類型:String
接受的值:4.0, 5.0, 5.1, latest
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

String

Hashtable

輸出

PSAzureOperationResponse