次の方法で共有


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" \

必須のパラメーター

--name -n

ブループリント割り当ての名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--blueprint-version

ブループリント定義の発行済みバージョンのリソース ID。

--description

複数行でこのリソースについて説明します。

--display-name

このリソースを説明する 1 行の文字列。

--identity-type

マネージド ID の種類。

プロパティ
Parameter group: Identity Arguments
規定値: SystemAssigned
指定可能な値: None, SystemAssigned, UserAssigned
--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--locks-excluded-principals

ブループリント ロックから除外された AAD プリンシパルの一覧。 最大 5 つのプリンシパルが許可されます。

--locks-mode

Lock mode.

プロパティ
指定可能な値: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

ブループリント割り当てのターゲット スコープに管理グループを使用します。 将来使用するために予約されています。 代わりに --subscription を使用してください。

プロパティ
Parameter group: Resource_scope Arguments
--parameters -p

ブループリント割り当てパラメーターの値。 JSON 文字列または JSON ファイル パスを指定できます。

--resource-group-value

リソース グループのキーと値のペア。 キーには、'artifact_name'(必須)、'name'、'location' があります。

--subscription -s

ブループリント割り当てのターゲット スコープにサブスクリプションを使用します。 オプションが指定されていない場合は、既定の susbcription が使用されます。

プロパティ
Parameter group: Resource_scope Arguments
--user-assigned-identity

リソースに関連付けられているユーザー割り当てマネージド ID。

プロパティ
Parameter group: Identity Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須のパラメーター

--name -n

ブループリント割り当ての名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--delete-behavior

deleteBehavior=all の場合、ブループリント割り当てによって作成されたリソースは削除されます。

プロパティ
指定可能な値: all, none
--management-group -m

ブループリントのスコープには管理グループを使用します。

プロパティ
Parameter group: Resource_scope Arguments
--subscription -s

ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。

プロパティ
Parameter group: Resource_scope Arguments
--yes -y

確認を求めないでください。

プロパティ
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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.

--management-group -m

ブループリントのスコープには管理グループを使用します。

プロパティ
Parameter group: Resource_scope Arguments
--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。

プロパティ
Parameter group: Pagination Arguments
--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

プロパティ
Parameter group: Pagination Arguments
--subscription -s

ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。

プロパティ
Parameter group: Resource_scope Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須のパラメーター

--name -n

ブループリント割り当ての名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--management-group -m

ブループリントのスコープには管理グループを使用します。

プロパティ
Parameter group: Resource_scope Arguments
--subscription -s

ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。

プロパティ
Parameter group: Resource_scope Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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]

必須のパラメーター

--name -n

ブループリント割り当ての名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--blueprint-version

ブループリント定義の発行済みバージョンのリソース ID。

--description

複数行でこのリソースについて説明します。

--display-name

このリソースを説明する 1 行の文字列。

--identity-type

マネージド ID の種類。

プロパティ
Parameter group: Identity Arguments
指定可能な値: None, SystemAssigned, UserAssigned
--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--locks-excluded-principals

ブループリント ロックから除外された AAD プリンシパルの一覧。 最大 5 つのプリンシパルが許可されます。

--locks-mode

Lock mode.

プロパティ
指定可能な値: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

ブループリント割り当てのターゲット スコープに管理グループを使用します。 将来使用するために予約されています。 代わりに --subscription を使用してください。

プロパティ
Parameter group: Resource_scope Arguments
--parameters -p

ブループリント割り当てパラメーターの値。 JSON 文字列または JSON ファイル パスを指定できます。

--resource-group-value

リソース グループのキーと値のペア。 キーには、'artifact_name'(必須)、'name'、'location' があります。

--subscription -s

ブループリント割り当てのターゲット スコープにサブスクリプションを使用します。 オプションが指定されていない場合は、既定の susbcription が使用されます。

プロパティ
Parameter group: Resource_scope Arguments
--user-assigned-identity

リソースに関連付けられているユーザー割り当てマネージド ID。

プロパティ
Parameter group: Identity Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須のパラメーター

--name -n

ブループリント割り当ての名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

プロパティ
Parameter group: Wait Condition Arguments
--deleted

削除されるまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
--exists

リソースが存在するまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
--interval

ポーリング間隔 (秒単位)。

プロパティ
Parameter group: Wait Condition Arguments
規定値: 30
--management-group -m

ブループリント割り当てのターゲット スコープに管理グループを使用します。 将来使用するために予約されています。 代わりに --subscription を使用してください。

プロパティ
Parameter group: Resource_scope Arguments
--subscription -s

ブループリント割り当てのターゲット スコープにサブスクリプションを使用します。 オプションが指定されていない場合は、既定の susbcription が使用されます。

プロパティ
Parameter group: Resource_scope Arguments
--timeout

最大待機時間 (秒単位)。

プロパティ
Parameter group: Wait Condition Arguments
規定値: 3600
--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須のパラメーター

--name -n

ブループリント割り当ての名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--management-group -m

ブループリントのスコープには管理グループを使用します。

プロパティ
Parameter group: Resource_scope Arguments
--subscription -s

ブループリントのスコープにはサブスクリプションを使用します。 --management-group が指定されていない場合、--subscription 値または既定のサブスクリプションがスコープとして使用されます。

プロパティ
Parameter group: Resource_scope Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

Output format.

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False