az deployment mg
管理グループで Azure Resource Manager テンプレートのデプロイを管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az deployment mg cancel |
管理グループでのデプロイを取り消します。 |
Core | GA |
az deployment mg create |
管理グループでデプロイを開始します。 |
Core | GA |
az deployment mg delete |
管理グループでのデプロイを削除します。 |
Core | GA |
az deployment mg export |
デプロイに使用するテンプレートをエクスポートします。 |
Core | GA |
az deployment mg list |
管理グループでのデプロイを一覧表示します。 |
Core | GA |
az deployment mg show |
管理グループでのデプロイを表示します。 |
Core | GA |
az deployment mg validate |
テンプレートが管理グループで有効かどうかを検証します。 |
Core | GA |
az deployment mg wait |
デプロイ条件が満たされるまで、CLI を待機状態にします。 |
Core | GA |
az deployment mg what-if |
管理グループ スコープで展開 What-If 操作を実行します。 |
Core | GA |
az deployment mg cancel
管理グループでのデプロイを取り消します。
az deployment mg cancel --management-group-id
--name
例
管理グループでのデプロイを取り消します。
az deployment mg cancel -m testmg -n deployment01
必須のパラメーター
管理グループ ID。
デプロイ名。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg create
管理グループでデプロイを開始します。
--template-file FILE の 1 つだけを指定してください |--template-uri URI |--template-spec を使用して ARM テンプレートを入力します。
az deployment mg create --location
--management-group-id
[--confirm-with-what-if]
[--handle-extended-json-format]
[--mode {Complete, Incremental}]
[--name]
[--no-prompt {false, true}]
[--no-wait]
[--parameters]
[--proceed-if-no-change]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
[--what-if]
[--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]
例
ローカル JSON ファイルのパラメーターを使用して、リモート テンプレート ファイルから管理グループにデプロイを作成します。
az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
--template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
JSON 文字列のパラメーターを使用して、ローカル テンプレート ファイルから管理グループでデプロイを作成します。
az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
--template-file azuredeploy.json \
--parameters '{ \"policyName\": { \"value\": \"policy2\" } }'
パラメーター ファイル、リモート パラメーター ファイル、およびキーと値のペアを選択的にオーバーライドして、ローカル テンプレートから管理グループにデプロイを作成します。
az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
--template-file azuredeploy.json --parameters @params.json \
--parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json
必須のパラメーター
デプロイ メタデータを格納する場所。
デプロイを作成する管理グループ ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
デプロイを実行する前に、デプロイ What-If を実行するようにコマンドに指示します。 続ける前に、リソースの変更を確認するように求められます。
オプション '--handle-extended-json-format/-j' は非推奨となり、今後のリリースで削除される予定です。
デプロイでの複数行やコメントを含む拡張テンプレート コンテンツの処理をサポートします。
リソースのデプロイに使用されるモード。 この値には、Incremental または Complete のいずれかを指定できます。 増分モードでは、テンプレートに含まれていない既存のリソースを削除せずにリソースがデプロイされます。 完全モードでは、リソースがデプロイされ、テンプレートに含まれていないリソース グループ内の既存のリソースが削除されます。 リソースを誤って削除する可能性があるため、完全モードを使用する場合は注意してください。
プロパティ | 値 |
---|---|
規定値: | Incremental |
指定可能な値: | Complete, Incremental |
デプロイ名。
ARM テンプレートの不足しているパラメーターのプロンプトを無効にするオプション。 値が true の場合、不足しているパラメーターを指定するようユーザーに求めるプロンプトは無視されます。 既定値は false です。
プロパティ | 値 |
---|---|
規定値: | False |
指定可能な値: | false, true |
実行時間の長い操作が完了するまで待つ必要はありません。
プロパティ | 値 |
---|---|
規定値: | False |
デプロイ パラメーターの値を指定します。
パラメーターは、@{path}
構文、JSON 文字列、または <KEY=VALUE>
ペアを使用してファイルから指定できます。 パラメーターは順番に評価されるため、値が 2 回割り当てられると、後者の値が使用されます。 最初にパラメーター ファイルを指定してから、KEY=VALUE 構文を使用して選択的にオーバーライドすることをお勧めします。
What-If の結果にリソースの変更が含まれている場合は、デプロイを実行するようにコマンドに指示します。 --confirm-with-what-if が設定されている場合に適用されます。
リンクされたテンプレートの場合に template-uri と共に使用されるクエリ文字列 (SAS トークン)。
テンプレート ファイルまたは Bicep ファイルへのパス。
テンプレート スペックのリソース ID。
テンプレート ファイルへの URI。
デプロイ What-If を実行するようにコマンドに指示します。
結果から除外するリソース変更の種類のスペース区切りの一覧 What-If。 --confirm-with-what-if が設定されている場合に適用されます。
プロパティ | 値 |
---|---|
指定可能な値: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
What-If 結果の形式。
--confirm-with-what-if
が設定されている場合に適用されます。
プロパティ | 値 |
---|---|
規定値: | FullResourcePayloads |
指定可能な値: | FullResourcePayloads, ResourceIdOnly |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg delete
管理グループでのデプロイを削除します。
az deployment mg delete --management-group-id
--name
[--no-wait]
例
管理グループでのデプロイを削除します。
az deployment mg delete -m testmg -n deployment01
必須のパラメーター
管理グループ ID。
デプロイ名。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
実行時間の長い操作が完了するまで待つ必要はありません。
プロパティ | 値 |
---|---|
規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg export
デプロイに使用するテンプレートをエクスポートします。
az deployment mg export --management-group-id
--name
例
管理グループでのデプロイに使用するテンプレートをエクスポートします。
az deployment mg export --management-group-id testmg --name MyDeployment
必須のパラメーター
管理グループ ID。
デプロイ名。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg list
管理グループでのデプロイを一覧表示します。
az deployment mg list --management-group-id
[--filter]
例
管理グループでのデプロイを一覧表示します。
az deployment mg list -m testmg
必須のパラメーター
管理グループ ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
OData 表記を使用して式をフィルター処理します。 --filter "provisioningState eq '{state}'" を使用して provisioningState をフィルター処理できます。 詳細については、https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parametersを参照してください。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg show
管理グループでのデプロイを表示します。
az deployment mg show --management-group-id
--name
例
管理グループでのデプロイを表示します。
az deployment mg show -m testmg -n deployment01
必須のパラメーター
管理グループ ID。
デプロイ名。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg validate
テンプレートが管理グループで有効かどうかを検証します。
--template-file FILE の 1 つだけを指定してください |--template-uri URI |--template-spec を使用して ARM テンプレートを入力します。
az deployment mg validate --location
--management-group-id
[--handle-extended-json-format]
[--name]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
例
テンプレートが管理グループで有効かどうかを検証します。
az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}
テンプレートが管理グループで有効かどうかを検証します。 (autogenerated)
az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json
必須のパラメーター
デプロイ メタデータを格納する場所。
デプロイを作成する管理グループ ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
オプション '--handle-extended-json-format/-j' は非推奨となり、今後のリリースで削除される予定です。
デプロイでの複数行やコメントを含む拡張テンプレート コンテンツの処理をサポートします。
デプロイ名。
ARM テンプレートの不足しているパラメーターのプロンプトを無効にするオプション。 値が true の場合、不足しているパラメーターを指定するようユーザーに求めるプロンプトは無視されます。 既定値は false です。
プロパティ | 値 |
---|---|
規定値: | False |
指定可能な値: | false, true |
デプロイ パラメーターの値を指定します。
パラメーターは、@{path}
構文、JSON 文字列、または <KEY=VALUE>
ペアを使用してファイルから指定できます。 パラメーターは順番に評価されるため、値が 2 回割り当てられると、後者の値が使用されます。 最初にパラメーター ファイルを指定してから、KEY=VALUE 構文を使用して選択的にオーバーライドすることをお勧めします。
リンクされたテンプレートの場合に template-uri と共に使用されるクエリ文字列 (SAS トークン)。
テンプレート ファイルまたは Bicep ファイルへのパス。
テンプレート スペックのリソース ID。
テンプレート ファイルへの URI。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg wait
デプロイ条件が満たされるまで、CLI を待機状態にします。
az deployment mg wait --management-group-id
--name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
必須のパラメーター
管理グループ ID。
デプロイ名。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
'provisioningState' が 'Succeeded' で作成されるまで待ちます。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
規定値: | False |
条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
削除されるまで待ちます。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
規定値: | False |
リソースが存在するまで待ちます。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
規定値: | False |
ポーリング間隔 (秒単位)。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
規定値: | 30 |
最大待機時間 (秒単位)。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
規定値: | 3600 |
provisioningState が 'Succeeded' で更新されるまで待ちます。
プロパティ | 値 |
---|---|
Parameter group: | Wait Condition Arguments |
規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az deployment mg what-if
管理グループ スコープで展開 What-If 操作を実行します。
--template-file FILE の 1 つだけを指定してください |--template-uri URI |--template-spec を使用して ARM テンプレートを入力します。
az deployment mg what-if --location
--management-group-id
[--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--name]
[--no-pretty-print]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--result-format {FullResourcePayloads, ResourceIdOnly}]
[--template-file]
[--template-spec]
[--template-uri]
例
管理グループで展開 What-If 操作を実行します。
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
ResourceIdOnly 形式の管理グループでデプロイ What-If 操作を実行します。
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly
結果を整形印刷せずに、管理グループで展開 What-If 操作を実行します。
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print
必須のパラメーター
デプロイ メタデータを格納する場所。
デプロイを作成する管理グループ ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
結果から除外するリソース変更の種類のスペース区切りの一覧 What-If。
プロパティ | 値 |
---|---|
指定可能な値: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
デプロイ名。
What-If 結果のプリプリントを無効にします。 設定すると、出力形式の種類が使用されます。
ARM テンプレートの不足しているパラメーターのプロンプトを無効にするオプション。 値が true の場合、不足しているパラメーターを指定するようユーザーに求めるプロンプトは無視されます。 既定値は false です。
プロパティ | 値 |
---|---|
規定値: | False |
指定可能な値: | false, true |
デプロイ パラメーターの値を指定します。
パラメーターは、@{path}
構文、JSON 文字列、または <KEY=VALUE>
ペアを使用してファイルから指定できます。 パラメーターは順番に評価されるため、値が 2 回割り当てられると、後者の値が使用されます。 最初にパラメーター ファイルを指定してから、KEY=VALUE 構文を使用して選択的にオーバーライドすることをお勧めします。
リンクされたテンプレートの場合に template-uri と共に使用されるクエリ文字列 (SAS トークン)。
What-If 結果の形式。
プロパティ | 値 |
---|---|
規定値: | FullResourcePayloads |
指定可能な値: | FullResourcePayloads, ResourceIdOnly |
テンプレート ファイルまたは Bicep ファイルへのパス。
テンプレート スペックのリソース ID。
テンプレート ファイルへの URI。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |