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 通信的凭据、帐户、租户和订阅
参数属性
参数集
(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。
输出