Import-AzureRmAutomationDscNodeConfiguration
AUTOMATION で MOF ドキュメントを DSC ノード構成としてインポートします。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Import-AzureRmAutomationDscNodeConfiguration
-Path <String>
-ConfigurationName <String>
[-Force]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-IncrementNodeConfigurationBuild]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Import-AzureRmAutomationDscConfiguration コマンドレットは、Managed Object Format (MOF) 構成ドキュメントを Desired State Configuration (DSC) ノード構成として Azure Automation にインポートします。 .mof ファイルのパスを指定します。
例
例 1: DSC ノード構成を Automation にインポートする
PS C:\>Import-AzureRmAutomationDscConfiguration -AutomationAccountName "Contoso17" -ResourceGroupName "ResourceGroup01" -ConfigurationName "ContosoConfiguration" -Path "C:\DSC\webserver.mof" -Forceこのコマンドは、DSC 構成 ContosoConfiguration の下で、webserver.mof という名前のファイルから Contoso17 という名前の Automation アカウントに DSC ノード構成をインポートします。 このコマンドは、 Force パラメーターを指定します。 ContosoConfiguration.webserver という名前の既存の DSC ノード構成がある場合、このコマンドによって置き換えられます。
例 2: DSC ノード構成を Automation にインポートし、既存の NodeConfiguration を上書きせず、新しいビルド バージョンを作成します。
PS C:\>Import-AzureRmAutomationDscConfiguration -AutomationAccountName "Contoso17" -ResourceGroupName "ResourceGroup01" -ConfigurationName "ContosoConfiguration" -Path "C:\DSC\webserver.mof" -IncrementNodeConfigurationBuildこのコマンドは、DSC 構成 ContosoConfiguration の下で、webserver.mof という名前のファイルから Contoso17 という名前の Automation アカウントに DSC ノード構成をインポートします。 このコマンドは、 Force パラメーターを指定します。 ContosoConfiguration.webserver という名前の既存の DSC ノード構成がある場合、このコマンドは ContosoConfiguration[2].webserver という名前の新しいビルド バージョンを追加します。
パラメーター
-AutomationAccountName
このコマンドレットが DSC ノード構成をインポートする Automation アカウントの名前を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ConfigurationName
インポートするノード構成の名前空間とコンテナーとして使用する Automation の DSC 構成の名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
| 型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
このコマンドレットが Automation の既存の DSC ノード構成を置き換えることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IncrementNodeConfigurationBuild
新しい Node Configuration ビルド バージョンを作成します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
このコマンドレットがインポートする MOF 構成ドキュメントのパスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceGroupName
このコマンドレットが DSC ノード構成をインポートするリソース グループの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |