次の方法で共有


Get-AzAutomationDscNode

Automation から 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 コマンドレットは、Azure Automation から APS Desired State Configuration (DSC) ノードを取得します。

例 1: すべての DSC ノードを取得する

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

このコマンドは、Contoso17 という名前の Automation アカウント内のすべての DSC ノードのメタデータを取得します。

例 2: DSC 構成のすべての DSC ノードを取得する

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

このコマンドは、Contoso17 という名前の Automation アカウント内のすべての DSC ノードのメタデータを取得します。このメタデータは、DSC 構成 ContosoConfiguration によって生成された DSC ノード構成にマップされます。

例 3: ID で DSC ノードを取得する

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

このコマンドは、Contoso17 という名前の Automation アカウントで指定された ID を持つ DSC ノードのメタデータを取得します。

例 4: 名前で DSC ノードを取得する

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

このコマンドは、Contoso17 という名前の Automation アカウントの Computer14 という名前の DSC ノードのメタデータを取得します。

例 5: DSC ノード構成にマップされているすべての DSC ノードを取得する

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

このコマンドは、ContosoConfiguration.webserver という名前の DSC ノード構成にマップされている、Contoso17 という名前の Automation アカウント内のすべての DSC ノードのメタデータを取得します。

パラメーター

-AutomationAccountName

このコマンドレットが取得する DSC ノードを含む Automation アカウントの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ConfigurationName

DSC 構成の名前を指定します。 このコマンドレットは、このパラメーターが指定する構成から生成されたノード構成に一致する DSC ノードを取得します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByConfiguration
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Id

このコマンドレットが取得する DSC ノードの一意の ID を指定します。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:NodeId

パラメーター セット

ById
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

このコマンドレットが取得する DSC ノードの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ノードネーム

パラメーター セット

ByName
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-NodeConfigurationName

このコマンドレットが取得するノード構成の名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByNodeConfiguration
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

このコマンドレットが DSC ノードを取得するリソース グループの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Status

このコマンドレットが取得する DSC ノードの状態を指定します。 有効な値は次のとおりです。

  • Compliant
  • NotCompliant
  • 失敗しました
  • 保留中
  • 受入済
  • 応答

パラメーターのプロパティ

型:DscNodeStatus
規定値:None
指定可能な値:Compliant, NotCompliant, Failed, Pending, Received, Unresponsive
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByAll
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNodeConfiguration
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

Guid

String

出力

DscNode