az agentfabric

Note

このリファレンスは、Azure CLI (バージョン 2.75.0 以降) の agentfabric 拡張機能の一部です。 拡張機能は、 az agentfabric コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細を確認します。

エージェントのFabricと関連するMicrosoftを管理します。NetworkSecurity リソース。 ルート コマンドは、エージェントFabricリソースを管理します。

エージェントのFabricと関連するMicrosoftを管理します。NetworkSecurity リソース。 ルートの作成、表示、一覧表示、更新、削除の各コマンドは、エージェント Fabric リソースを管理します。

コマンド

Name 説明 型 状態
az agentfabric aks

エージェントFabricコンピューティング登録を管理します。

Extension GA
az agentfabric aks attach

エージェント Fabricにコンピューティング リソースをアタッチします。

Extension GA
az agentfabric aks detach

エージェントFabricコンピューティングの関連付けを削除します。

Extension GA
az agentfabric aks list

エージェント Fabricの下にコンピューティングの関連付けを一覧表示します。

Extension GA
az agentfabric aks show

エージェントFabricコンピューティングの関連付けを表示します。

Extension GA
az agentfabric aks update

パッチ登録タグ、SKU、またはゲートウェイ IP。

Extension GA
az agentfabric aks wait

条件が満たされるまで CLI を待機状態にします。

Extension GA
az agentfabric create

エージェント Fabric リソースを作成または置換します。

Extension GA
az agentfabric delete

エージェント Fabric リソースを削除します。

Extension GA
az agentfabric egress-trust-bundle

エージェントFabricエグレス信頼バンドルを読み取ります。

Extension GA
az agentfabric egress-trust-bundle list

エージェント Fabricのエグレス信頼バンドルを一覧表示します。

Extension GA
az agentfabric egress-trust-bundle show

エージェント Fabricの既定のエグレス信頼バンドルを表示します。

Extension GA
az agentfabric list

エージェントFabricリソースを一覧表示します。

Extension GA
az agentfabric member

エージェント Fabric メンバーを管理します。

Extension GA
az agentfabric member list

エージェント Fabricのメンバーを一覧表示します。

Extension GA
az agentfabric member show

エージェント Fabric メンバーを表示します。

Extension GA
az agentfabric member wait

条件が満たされるまで CLI を待機状態にします。

Extension GA
az agentfabric policy-group

独立したエージェント Fabric ポリシー グループを管理します。

Extension GA
az agentfabric policy-group create

独立したMicrosoftを作成します。NetworkSecurity ポリシー グループ。

Extension GA
az agentfabric policy-group delete

独立したポリシー グループを削除します。

Extension GA
az agentfabric policy-group list

独立したポリシー グループを一覧表示します。

Extension GA
az agentfabric policy-group show

独立したポリシー グループを表示します。

Extension GA
az agentfabric policy-group update

独立したポリシー グループのタグを更新します。

Extension GA
az agentfabric policy-group wait

条件が満たされるまで CLI を待機状態にします。

Extension GA
az agentfabric show

エージェント Fabric リソースを表示します。

Extension GA
az agentfabric update

エージェント Fabric タグまたはシステム割り当て ID を更新します。

Extension GA
az agentfabric wait

条件が満たされるまで CLI を待機状態にします。

Extension GA

az agentfabric create

エージェント Fabric リソースを作成または置換します。

エージェント Fabricを作成します。これには、オプションのシステム割り当て ID と、顧客が所有する完全なコンテンツ検査エンドポイント/API キー ペアが含まれます。 検査プロファイルを省略するか、空のオブジェクトを指定しても、既存のFabricの接続変更は要求されません。

az agentfabric create --name
                      --resource-group
                      [--acquire-policy-token]
                      [--change-reference]
                      [--content-inspection-profile --inspection-profile]
                      [--default-policy-groups]
                      [--identity]
                      [--location]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--tags]
                      [--trust-domain]

例

顧客所有のコンテンツ検査を使用してエージェント Fabricを作成する

az agentfabric create --resource-group rgnetworksecurity --name testAIFabric --location westus3 --trust-domain contoso.agentfabric --identity "{type:SystemAssigned}" --inspection-profile "{endpoint:'https://contoso.cognitiveservices.azure.com/',api-key:<content-safety-api-key>}"

コンテンツ検査なしでエージェント Fabricを作成する

az agentfabric create --resource-group rgnetworksecurity --name testAIFabric --location westus3 --trust-domain contoso.agentfabric

必須パラメーター

--name -n

AgentFabric の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--content-inspection-profile --inspection-profile -p

顧客の Azure Content Safety アカウントへの接続。 API バージョン 2026-10-07-preview 以降で作成された新しいファブリックの場合、このプロファイルを省略するか、 {} を指定すると、検査機能は要求されません。また、プラットフォーム所有のアカウントや共有キーフォールバックは使用されません。 既存のファブリックの場合、古いクライアントからの要求を含む PUT からプロファイルを省略するか、 {} を指定すると、顧客所有の接続、レガシリージョン接続、または接続の欠如が保持されます。 空のオブジェクトは、保存されている置換プロファイルではなく、接続の変更がない要求です。 省略も {} も、接続の削除、プローブ、または接続の作成、または保留中の接続更新の取り消しは行いません。 その他のFabric フィールドとポリシー互換性規則は引き続き適用されます。 空でない要求プロファイルでは、変更されていないエンドポイントであっても、endpoint と apiKey の両方が必要です。 PUT では、完全なペアを指定することで、キーをローテーションしたり、エンドポイントを置き換えたりできます。 タグまたは ID のみの PATCH 要求では、このプロファイルを変更できません。 プロファイルのない既存のレガシ ファブリックでは、そのリージョンの Content Safety エンドポイントと認証パスが保持されます。 省略または {} は、接続プローブ、アカウント管理呼び出し、キーの取得、または資格情報の要件をトリガーしません。 完全なプロファイルを指定すると、顧客所有の接続が明示的に構成されます。リージョンの資格情報への自動変換や接続の失敗フォールバックはありません。 顧客がアカウントを所有、支払い、運用している。 サービスでは、作成、予約、管理、削除は行われません。 サービスは、アクティブ化の前に、新規または変更されたエンドポイント/資格情報の構成と必要な Content Safety API を検証します。構成だけでは、準備やアクティブなポリシーの適用は示されません。 変更されていない構成、GET、およびリストでは、新しい検証要求はトリガーされません。 失敗した置換では、既存の接続と資格情報 (レガシリージョン接続を含む) が保持されます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ 値
パラメーター グループ: Properties Arguments
--default-policy-groups

このファブリックのすべてのメンバーに適用する既定のポリシー グループ。 検査接続が構成されていないファブリックは、そのポリシーのセレクターが現在トラフィックと一致しない場合でも、ContentInspection ポリシーを含むグループを参照できません。 既存のファブリックの場合、PUT が contentInspectionProfile を省略するか、空のオブジェクトを指定するときに、格納されている構成が互換性によって使用されます。 既存のレガシ ファブリックは、新しいプローブなしで検査の前提条件を満たすリージョンのコンテンツ セーフティ接続を保持します。 まだ検証中の接続は、存在しない接続ではありません。 グループ参照の削除は引き続き許可され、他の検証が適用されます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ 値
パラメーター グループ: Properties Arguments
--identity

このファブリックに割り当てられたマネージド サービス ID。 サービスは、それを使用して、顧客の代わりにファブリックに関連付けられているクラスターに到達します。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ 値
パラメーター グループ: Resource Arguments
--location -l

リソースが存在する地理的な場所 を指定しない場合は、リソース グループの場所が使用されます。

プロパティ 値
パラメーター グループ: Resource Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ 値
指定可能な値: 0, 1, f, false, n, no, t, true, y, yes
--tags

リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ 値
パラメーター グループ: Resource Arguments
--trust-domain

このファブリックのメンバー ID をスコープとする信頼ドメイン。 これは各メンバーの ID の先頭コンポーネントであり、 <trustDomain>/<agentFabricName>/<memberName>形式になります。 作成時に設定し、その後は不変。省略すると、共有の既定の信頼ドメイン microsoft.agentfabric が使用されます。

プロパティ 値
パラメーター グループ: Properties Arguments
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

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

プロパティ 値
規定値: False

az agentfabric delete

エージェント Fabric リソースを削除します。

az agentfabric delete [--acquire-policy-token]
                      [--change-reference]
                      [--ids]
                      [--name]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--resource-group]
                      [--subscription]
                      [--yes]

例

エージェント Fabricを削除する

az agentfabric delete --resource-group rgnetworksecurity --name testAIFabric

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--name -n

AgentFabric の名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ 値
指定可能な値: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--yes -y

確認のダイアログを表示しません。

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

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False

az agentfabric list

エージェントFabricリソースを一覧表示します。

az agentfabric list [--max-items]
                    [--next-token]
                    [--resource-group]

例

リソース グループ内のエージェント ファブリックを一覧表示する

az agentfabric list --resource-group rgnetworksecurity

サブスクリプション内の Agent Fabric を一覧表示する

az agentfabric list

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--max-items

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

プロパティ 値
パラメーター グループ: Pagination Arguments
--next-token

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

プロパティ 値
パラメーター グループ: Pagination Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

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

プロパティ 値
規定値: False

az agentfabric show

エージェント Fabric リソースを表示します。

az agentfabric show [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

例

エージェント Fabricを表示する

az agentfabric show --resource-group rgnetworksecurity --name testAIFabric

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--name -n

AgentFabric の名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False

az agentfabric update

エージェント Fabric タグまたはシステム割り当て ID を更新します。

タグとシステム割り当て ID のみにパッチを適用します。 コンテンツ検査、信頼ドメイン、および既定のポリシー グループは PATCH 入力ではありません。

az agentfabric update [--acquire-policy-token]
                      [--change-reference]
                      [--identity]
                      [--ids]
                      [--name]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--resource-group]
                      [--subscription]
                      [--tags]

例

エージェントFabricタグと ID を更新する

az agentfabric update --resource-group rgnetworksecurity --name testAIFabric --tags "{env:prod}" --identity "{type:SystemAssigned}"

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--identity

このファブリックに割り当てられたマネージド サービス ID。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ 値
パラメーター グループ: Properties Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--name -n

AgentFabric の名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ 値
指定可能な値: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--tags

リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

プロパティ 値
パラメーター グループ: Properties Arguments
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False

az agentfabric wait

条件が満たされるまで CLI を待機状態にします。

az agentfabric wait [--acquire-policy-token]
                    [--change-reference]
                    [--created]
                    [--custom]
                    [--deleted]
                    [--exists]
                    [--ids]
                    [--interval]
                    [--name]
                    [--resource-group]
                    [--subscription]
                    [--timeout]
                    [--updated]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--created

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

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

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

プロパティ 値
パラメーター グループ: Wait Condition Arguments
--deleted

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

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

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

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

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--interval

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

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: 30
--name -n

AgentFabric の名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--timeout

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

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: 3600
--updated

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

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

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False