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

Register-AzAutomationDscNode

将运行 Windows OS 的 Azure 虚拟机注册为自动化帐户的 DSC 节点。

语法

Default (默认值)

Register-AzAutomationDscNode
    -AzureVMName <String>
    [-NodeConfigurationName <String>]
    [-ConfigurationMode <String>]
    [-ConfigurationModeFrequencyMins <Int32>]
    [-RefreshFrequencyMins <Int32>]
    [-RebootNodeIfNeeded <Boolean>]
    [-ActionAfterReboot <String>]
    [-AllowModuleOverwrite <Boolean>]
    [-AzureVMResourceGroup <String>]
    [-AzureVMLocation <String>]
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

Register-AzAutomationDscNode cmdlet 在 Azure 自动化帐户中将 Azure 虚拟机注册为 APS Desired State Configuration (DSC) 节点。 此 cmdlet 将运行 Windows OS 的 VM 注册为帐户的自动化 DSC 节点。

如果需要将节点注册到其他订阅中的自动化帐户,则需要使用 ARM 模板而不是 cmdlet。 有关更多详细信息,请参阅 Azure 自动化 文档

示例

示例 1:将 Azure 虚拟机注册为 Azure DSC 节点

Register-AzAutomationDscNode -AutomationAccountName "Contoso17" -AzureVMName "VirtualMachine01" -ResourceGroupName "ResourceGroup01"-NodeConfigurationName "ContosoConfiguration.webserver"

此命令将名为 VirtualMachine01 的 Azure 虚拟机注册为名为 Contoso17 的自动化帐户中的 DSC 节点。

参数

-ActionAfterReboot

指定虚拟机重启后执行的作。 有效值为:

  • ContinueConfiguration
  • StopConfiguration

参数属性

类型:String
默认值:None
接受的值:ContinueConfiguration, StopConfiguration
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AllowModuleOverwrite

指定此 DSC 节点是否从 Azure 自动化 DSC 拉取服务器下载的新配置替换目标节点上已有的现有模块。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AutomationAccountName

指定此 cmdlet 在其中注册虚拟机的自动化帐户的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AzureVMLocation

Azure VM 位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AzureVMName

要注册管理 Azure 自动化 DSC 的 Azure 虚拟机的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-AzureVMResourceGroup

Azure VM 资源组名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ConfigurationMode

指定 DSC 配置模式。 有效值为:

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • ApplyOnly

参数属性

类型:String
默认值:None
接受的值:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ConfigurationModeFrequencyMins

指定 DSC 后台应用程序尝试在目标节点上实现当前配置的频率(以分钟为单位)。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NodeConfigurationName

指定此 cmdlet 将虚拟机配置为从 Azure Automation DSC 拉取的节点配置的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-RebootNodeIfNeeded

指定是否需要重启虚拟机。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-RefreshFrequencyMins

指定本地 Configuration Manager 与 Azure Automation DSC 请求服务器联系以下载最新节点配置的频率(以分钟为单位)。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceGroupName

指定资源组的名称。 此 cmdlet 注册虚拟机的自动化帐户属于此参数指定的资源组。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

Int32

Boolean

输出

Void