次の方法で共有

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 アカウントの名前を指定します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ConfigurationName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

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

型:Guid
Aliases:NodeId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

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

型:String
Aliases:NodeName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NodeConfigurationName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceGroupName

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Status

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

  • 対応
  • NotCompliant
  • Failed
  • 保留中
  • 入庫済
  • 応答なし
型:DscNodeStatus
指定可能な値:Compliant, NotCompliant, Failed, Pending, Received, Unresponsive
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Guid

String

出力

DscNode