Start-AzureRmAutomationDscCompilationJob
Automation で DSC 構成をコンパイルします。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Start-AzureRmAutomationDscCompilationJob
[-ConfigurationName] <String>
[-Parameters <IDictionary>]
[-ConfigurationData <IDictionary>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-IncrementNodeConfigurationBuild]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Start-AzureRmAutomationDscCompilationJob コマンドレットは、Azure Automation で APS Desired State Configuration (DSC) 構成をコンパイルします。
例
例 1: Automation で Azure DSC 構成をコンパイルする
PS C:\>$Params = @{"StringParam"="Hello World";"IntegerParam"=32}
PS C:\> Start-AzureRmAutomationDscCompilationJob -ConfigurationName "Config01" -Parameters $Params -ResourceGroupName "ResourceGroup01"最初のコマンドは、パラメーターのディクショナリを作成し、$Params変数に格納します。 2 番目のコマンドは、Config01 という名前の DSC 構成をコンパイルします。 このコマンドには、DSC 構成パラメーターの$Paramsの値が含まれています。
例 2: 新しい Node Configuration ビルド バージョンを使用して Automation で Azure DSC 構成をコンパイルする。
PS C:\>$Params = @{"StringParam"="Hello World";"IntegerParam"=32}
PS C:\> Start-AzureRmAutomationDscCompilationJob -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: | 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 |