az blueprint assignment
Note
This reference is part of the blueprint extension for the Azure CLI (version 2.50.0 or higher). 拡張機能は、az blueprint assignment コマンドを初めて実行するときに自動的にインストールされます。 Learn more about extensions.
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンド グループは暗黙的に非推奨となります。
ブループリントの割り当てを管理するコマンド。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az blueprint assignment create |
ブループリントの割り当てを作成します。 |
Extension | Deprecated |
az blueprint assignment delete |
ブループリントの割り当てを削除します。 |
Extension | プレビューと非推奨 |
az blueprint assignment list |
サブスクリプション内のブループリントの割り当てを一覧表示します。 |
Extension | プレビューと非推奨 |
az blueprint assignment show |
ブループリントの割り当てを取得します。 |
Extension | プレビューと非推奨 |
az blueprint assignment update |
ブループリントの割り当てを更新します。 |
Extension | Deprecated |
az blueprint assignment wait |
ブループリント割り当ての条件が満たされるまで、CLI を待機状態にします。 |
Extension | Deprecated |
az blueprint assignment who |
Blueprint Servie Principal Name objectId を取得します。 |
Extension | プレビューと非推奨 |
az blueprint assignment create
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
ブループリントの割り当てを作成します。
az blueprint assignment create --name
[--blueprint-version]
[--description]
[--display-name]
[--identity-type {None, SystemAssigned, UserAssigned}]
[--location]
[--locks-excluded-principals]
[--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
[--management-group]
[--parameters]
[--resource-group-value]
[--subscription]
[--user-assigned-identity]
例
システム割り当てマネージド ID を使用した割り当て
az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \
ユーザー割り当てマネージド ID を使用した割り当て
az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \
必須のパラメーター
ブループリント割り当ての名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
ブループリント定義の発行済みバージョンのリソース ID。
複数行でこのリソースについて説明します。
このリソースを説明する 1 行の文字列。
マネージド ID の種類。
プロパティ | 値 |
---|---|
Parameter group: | Identity Arguments |
規定値: | SystemAssigned |
指定可能な値: | None, SystemAssigned, UserAssigned |
Location. 値のソース: az account list-locations
az configure --defaults location=<location>
を使用して、既定の場所を構成できます。
ブループリント ロックから除外された AAD プリンシパルの一覧。 最大 5 つのプリンシパルが許可されます。
Lock mode.
プロパティ | 値 |
---|---|
指定可能な値: | AllResourcesDoNotDelete, AllResourcesReadOnly, None |
ブループリント割り当てのターゲット スコープに管理グループを使用します。 将来使用するために予約されています。 代わりに --subscription を使用してください。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
ブループリント割り当てパラメーターの値。 JSON 文字列または JSON ファイル パスを指定できます。
リソース グループのキーと値のペア。 キーには、'artifact_name'(必須)、'name'、'location' があります。
ブループリント割り当てのターゲット スコープにサブスクリプションを使用します。 オプションが指定されていない場合は、既定の susbcription が使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
リソースに関連付けられているユーザー割り当てマネージド ID。
プロパティ | 値 |
---|---|
Parameter group: | Identity Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az blueprint assignment delete
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
ブループリントの割り当てを削除します。
az blueprint assignment delete --name
[--delete-behavior {all, none}]
[--management-group]
[--subscription]
[--yes]
例
割り当てを削除する
az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment
必須のパラメーター
ブループリント割り当ての名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
deleteBehavior=all の場合、ブループリント割り当てによって作成されたリソースは削除されます。
プロパティ | 値 |
---|---|
指定可能な値: | all, none |
ブループリントのスコープには管理グループを使用します。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
確認を求めないでください。
プロパティ | 値 |
---|---|
規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az blueprint assignment list
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
サブスクリプション内のブループリントの割り当てを一覧表示します。
az blueprint assignment list [--management-group]
[--max-items]
[--next-token]
[--subscription]
例
List assignments
az blueprint assignment list --subscription MySubscription
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
ブループリントのスコープには管理グループを使用します。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token
トークン値を指定します。
プロパティ | 値 |
---|---|
Parameter group: | Pagination Arguments |
ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。
プロパティ | 値 |
---|---|
Parameter group: | Pagination Arguments |
ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az blueprint assignment show
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
ブループリントの割り当てを取得します。
az blueprint assignment show --name
[--management-group]
[--subscription]
例
割り当てを表示する
az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment
必須のパラメーター
ブループリント割り当ての名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
ブループリントのスコープには管理グループを使用します。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az blueprint assignment update
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
ブループリントの割り当てを更新します。
az blueprint assignment update --name
[--blueprint-version]
[--description]
[--display-name]
[--identity-type {None, SystemAssigned, UserAssigned}]
[--location]
[--locks-excluded-principals]
[--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
[--management-group]
[--parameters]
[--resource-group-value]
[--subscription]
[--user-assigned-identity]
必須のパラメーター
ブループリント割り当ての名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
ブループリント定義の発行済みバージョンのリソース ID。
複数行でこのリソースについて説明します。
このリソースを説明する 1 行の文字列。
マネージド ID の種類。
プロパティ | 値 |
---|---|
Parameter group: | Identity Arguments |
指定可能な値: | None, SystemAssigned, UserAssigned |
Location. 値のソース: az account list-locations
az configure --defaults location=<location>
を使用して、既定の場所を構成できます。
ブループリント ロックから除外された AAD プリンシパルの一覧。 最大 5 つのプリンシパルが許可されます。
Lock mode.
プロパティ | 値 |
---|---|
指定可能な値: | AllResourcesDoNotDelete, AllResourcesReadOnly, None |
ブループリント割り当てのターゲット スコープに管理グループを使用します。 将来使用するために予約されています。 代わりに --subscription を使用してください。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
ブループリント割り当てパラメーターの値。 JSON 文字列または JSON ファイル パスを指定できます。
リソース グループのキーと値のペア。 キーには、'artifact_name'(必須)、'name'、'location' があります。
ブループリント割り当てのターゲット スコープにサブスクリプションを使用します。 オプションが指定されていない場合は、既定の susbcription が使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
リソースに関連付けられているユーザー割り当てマネージド ID。
プロパティ | 値 |
---|---|
Parameter group: | Identity Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az blueprint assignment wait
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
ブループリント割り当ての条件が満たされるまで、CLI を待機状態にします。
az blueprint assignment wait --name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--management-group]
[--subscription]
[--timeout]
[--updated]
例
ブループリント割り当てが正常にプロビジョニングされるまで、CLI スクリプトの次の行の実行を一時停止します。
az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created
必須のパラメーター
ブループリント割り当ての名前。
省略可能のパラメーター
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 |
ブループリント割り当てのターゲット スコープに管理グループを使用します。 将来使用するために予約されています。 代わりに --subscription を使用してください。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
ブループリント割り当てのターゲット スコープにサブスクリプションを使用します。 オプションが指定されていない場合は、既定の susbcription が使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
最大待機時間 (秒単位)。
プロパティ | 値 |
---|---|
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/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az blueprint assignment who
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
ブループリントと関連するコマンドは、2026 年 7 月に非推奨となる予定です。 お客様は、テンプレート スペックとデプロイ スタックに移行して、その日付を超えたシナリオをサポートすることをお勧めします。 移行に関するドキュメントは、 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprintで入手できます。 コマンド グループ 'az blueprint' は非推奨であり、今後のリリースで削除されるため、このコマンドは暗黙的に非推奨となります。
Blueprint Servie Principal Name objectId を取得します。
az blueprint assignment who --name
[--management-group]
[--subscription]
例
SPN objectId を取得する
az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment
必須のパラメーター
ブループリント割り当ての名前。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
ブループリントのスコープには管理グループを使用します。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。
プロパティ | 値 |
---|---|
Parameter group: | Resource_scope Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
Output format.
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |