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
必須パラメーター
AgentFabric の名前。
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
顧客の 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 |
このファブリックのすべてのメンバーに適用する既定のポリシー グループ。 検査接続が構成されていないファブリックは、そのポリシーのセレクターが現在トラフィックと一致しない場合でも、ContentInspection ポリシーを含むグループを参照できません。 既存のファブリックの場合、PUT が contentInspectionProfile を省略するか、空のオブジェクトを指定するときに、格納されている構成が互換性によって使用されます。 既存のレガシ ファブリックは、新しいプローブなしで検査の前提条件を満たすリージョンのコンテンツ セーフティ接続を保持します。 まだ検証中の接続は、存在しない接続ではありません。 グループ参照の削除は引き続き許可され、他の検証が適用されます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Properties Arguments |
このファブリックに割り当てられたマネージド サービス ID。 サービスは、それを使用して、顧客の代わりにファブリックに関連付けられているクラスターに到達します。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Arguments |
リソースが存在する地理的な場所 を指定しない場合は、リソース グループの場所が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Arguments |
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Arguments |
このファブリックのメンバー ID をスコープとする信頼ドメイン。 これは各メンバーの ID の先頭コンポーネントであり、 <trustDomain>/<agentFabricName>/<memberName>形式になります。 作成時に設定し、その後は不変。省略すると、共有の既定の信頼ドメイン microsoft.agentfabric が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Properties Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
AgentFabric の名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
確認のダイアログを表示しません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Pagination Arguments |
ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Pagination Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az agentfabric show
エージェント Fabric リソースを表示します。
az agentfabric show [--ids]
[--name]
[--resource-group]
[--subscription]
例
エージェント Fabricを表示する
az agentfabric show --resource-group rgnetworksecurity --name testAIFabric
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
AgentFabric の名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このファブリックに割り当てられたマネージド サービス ID。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Properties Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
AgentFabric の名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 0, 1, f, false, n, no, t, true, y, yes |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Properties Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
'provisioningState' が 'Succeeded' で作成されるまで待ちます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
| 規定値: | False |
条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
削除されるまで待ちます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
| 規定値: | False |
リソースが存在するまで待ちます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
| 規定値: | False |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
ポーリング間隔 (秒単位)。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
| 規定値: | 30 |
AgentFabric の名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
最大待機時間 (秒単位)。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
| 規定値: | 3600 |
provisioningState が 'Succeeded' で更新されるまで待ちます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Wait Condition Arguments |
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |