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

Get-AzAutomationDscNode

从自动化获取 DSC 节点。

语法

ByAll (默认值)

Get-AzAutomationDscNode
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    [-Status <DscNodeStatus>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ById

Get-AzAutomationDscNode
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -Id <Guid>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByName

Get-AzAutomationDscNode
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -Name <String>
    [-Status <DscNodeStatus>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByNodeConfiguration

Get-AzAutomationDscNode
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -NodeConfigurationName <String>
    [-Status <DscNodeStatus>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByConfiguration

Get-AzAutomationDscNode
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -ConfigurationName <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

Get-AzAutomationDscNode cmdlet 从 Azure 自动化获取 APS Desired State Configuration (DSC) 节点。

示例

示例 1:获取所有 DSC 节点

Get-AzAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17"

此命令获取名为 Contoso17 的自动化帐户中所有 DSC 节点的元数据。

示例 2:获取 DSC 配置的所有 DSC 节点

Get-AzAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -ConfigurationName "ContosoConfiguration"

此命令获取映射到 DSC 配置 ContosoConfiguration 生成的 DSC 节点配置的自动化帐户中所有 DSC 节点的元数据。

示例 3:按 ID 获取 DSC 节点

Get-AzAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Id c0a1718e-d8be-4fa3-91b6-82e1d3a36298

此命令在名为 Contoso17 的自动化帐户中获取具有指定 ID 的 DSC 节点上的元数据。

示例 4:按名称获取 DSC 节点

Get-AzAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Name "Computer14"

此命令在名为 Contoso17 的自动化帐户中获取名为 Computer14 的 DSC 节点上的元数据。

示例 5:获取映射到 DSC 节点配置的所有 DSC 节点

Get-AzAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -NodeConfigurationName "ContosoConfiguration.webserver"

此命令获取名为 Contoso17 的自动化帐户中所有 DSC 节点的元数据,这些节点映射到名为 ContosoConfiguration.webserver 的 DSC 节点配置。

参数

-AutomationAccountName

指定包含此 cmdlet 获取的 DSC 节点的自动化帐户的名称。

参数属性

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

参数集

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

-ConfigurationName

指定 DSC 配置的名称。 此 cmdlet 获取与此参数指定的配置生成的节点配置匹配的 DSC 节点。

参数属性

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

参数集

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

-DefaultProfile

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

参数属性

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

参数集

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

-Id

指定此 cmdlet 获取的 DSC 节点的唯一 ID。

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False
别名:NodeId

参数集

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

-Name

指定此 cmdlet 获取的 DSC 节点的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:节点名称

参数集

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

-NodeConfigurationName

指定此 cmdlet 获取的节点配置的名称。

参数属性

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

参数集

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

-ResourceGroupName

指定此 cmdlet 获取 DSC 节点的资源组的名称。

参数属性

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

参数集

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

-Status

指定此 cmdlet 获取的 DSC 节点的状态。 有效值为:

  • Compliant
  • NotCompliant
  • 已失败
  • Pending
  • 已收到
  • 反应 迟钝

参数属性

类型:DscNodeStatus
默认值:None
接受的值:Compliant, NotCompliant, Failed, Pending, Received, Unresponsive
支持通配符:False
不显示:False

参数集

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

CommonParameters

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

输入

Guid

String

输出

DscNode