Start-AzAutomationDscCompilationJob

モジュール:

Az.Automation

Automation で DSC 構成をコンパイルします。

構文

Start-AzAutomationDscCompilationJob
     [-ConfigurationName] <String>
     [-Parameters <IDictionary>]
     [-ConfigurationData <IDictionary>]
     [-ResourceGroupName] <String>
     [-AutomationAccountName] <String>
     [-DefaultProfile <IAzureContextContainer>]
     [-IncrementNodeConfigurationBuild]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-AzAutomationDscCompilationJob コマンドレットは、Azure Automation で APS Desired State Configuration (DSC) 構成をコンパイルします。

例

例 1: Automation で Azure DSC 構成をコンパイルする

$Params = @{"StringParam"="Hello World";"IntegerParam"=32}
Start-AzAutomationDscCompilationJob -ConfigurationName "Config01" -Parameters $Params -ResourceGroupName "ResourceGroup01"

最初のコマンドは、パラメーターのディクショナリを作成し、$Params変数に格納します。 2 番目のコマンドは、Config01 という名前の DSC 構成をコンパイルします。 このコマンドには、DSC 構成パラメーターの$Paramsの値が含まれています。

例 2: 新しい Node Configuration ビルド バージョンを使用して Automation で Azure DSC 構成をコンパイルする。

$Params = @{"StringParam"="Hello World";"IntegerParam"=32}
Start-AzAutomationDscCompilationJob -ConfigurationName "Config01" -Parameters $Params -ResourceGroupName "ResourceGroup01" -IncrementNodeConfigurationBuild

最初の例と同様に、最初のコマンドはパラメーターのディクショナリを作成し、$Params変数に格納します。 2 番目のコマンドは、Config01 という名前の DSC 構成をコンパイルします。 このコマンドには、DSC 構成パラメーターの$Paramsの値が含まれています。 Config01[<2>].<NodeName>という名前の新しいノード構成を作成することによって、以前の既存のノード構成はオーバーライドされません。 バージョン番号は、既に存在する既存のバージョン番号に基づいてインクリメントされます。

パラメーター

-AutomationAccountName

このコマンドレットがコンパイルする DSC 構成を含む Automation アカウントの名前を指定します。

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

-ConfigurationData

DSC 構成の構成データのディクショナリを指定します。

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

-ConfigurationName

このコマンドレットがコンパイルする DSC 構成の名前を指定します。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DefaultProfile

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

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

-IncrementNodeConfigurationBuild

新しい Node Configuration ビルド バージョンを作成します。

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

-Parameters

このコマンドレットが DSC 構成のコンパイルに使用するパラメーターのディクショナリを指定します。

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

-ResourceGroupName

このコマンドレットが構成をコンパイルするリソース グループの名前を指定します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

String

出力

CompilationJob

関連リンク

• Get-AzAutomationDscCompilationJob
• Get-AzAutomationDscCompilationJobOutput