Get-AzureRmAutomationDscNode

モジュール:

AzureRM.Automation

Automation から DSC ノードを取得します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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

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

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

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

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

説明

Get-AzureRmAutomationDscNode コマンドレットは、Azure Automation から APS Desired State Configuration (DSC) ノードを取得します。

例

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

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17"

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

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

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -ConfigurationName "ContosoConfiguration"

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

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

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Id c0a1718e-d8be-4fa3-91b6-82e1d3a36298

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

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

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Name "Computer14"

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

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

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -NodeConfigurationName "ContosoConfiguration.webserver"

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

パラメーター

-AutomationAccountName

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	Guid
Aliases:	NodeId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	NodeName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NodeConfigurationName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Status

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

• 対応
• NotCompliant
• Failed
• 保留中
• 入庫済
• 応答なし

Type:	DscNodeStatus
Accepted values:	Compliant, NotCompliant, Failed, Pending, Received, Unresponsive
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Guid

String

出力

DscNode

関連リンク

• Register-AzureRmAutomationDscNode
• Set-AzureRmAutomationDscNode
• Unregister-AzureRmAutomationDscNode