你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

说明

Set-AzVMDscExtension cmdlet 在资源组中的虚拟机上配置 Windows PowerShell Desired State Configuration (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 的配置,并指定配置数据和参数。 此命令还允许将扩展处理程序自动更新到最新版本。 Sample.ps1.zip以前是使用 Publish-AzVMDscConfiguration 上传的。

参数

-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 资源管理器 资源的名称。 默认值为 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