pac copilot-studio

(プレビュー)Copilot Studioエージェントを管理し、テナント ライセンス レポートをエクスポートします。

Commands

命令 Description
pac copilot-studio delete-copilot-agent (プレビュー)ボットを削除します。
pac copilot-studio download-agent-channel-manifest (プレビュー)指定したエージェントとチャネルのチャネル マニフェスト パッケージを zip ファイルとしてダウンロードします。 現時点では、"M365" チャネルのみがサポートされています。
pac copilot-studio download-licensing-report-file (プレビュー)生成されたライセンス レポートを gzip 圧縮 CSV ファイルとしてダウンロードします。 レポート操作によって返されるファイル名を、成功状態で使用します。
pac copilot-studio generate-licensing-report (プレビュー)要求された日付範囲でテナントのCopilot Studio ライセンス レポートの生成を開始します。 生成は非同期的に実行されます。Location ヘッダーの URL をポーリングして状態を確認します。 グローバル、Dynamics 365、または Power Platform 管理者ロールが必要です。
pac copilot-studio get-bot-quarantine-status (プレビュー)ボットの検疫状態を取得します。
pac copilot-studio get-connector-consent-bypass (プレビュー)ボットの管理者コネクタの同意バイパス設定を取得します。
pac copilot-studio get-licensing-report-operation (プレビュー)ライセンス レポート生成操作の状態を取得します。 状態が [成功] の場合、応答にはレポート ファイル名が含まれており、Location ヘッダーにはダウンロード URL が含まれます。
pac copilot-studio get-maker-evaluation-test-run (プレビュー)特定のメーカー評価テストの実行の状態と結果を取得します。
pac copilot-studio get-maker-evaluation-test-set (プレビュー)ボットの作成者評価用の特定のテスト セットを取得します。
pac copilot-studio list-maker-evaluation-test-runs (プレビュー)ボットのすべての Maker 評価テストの実行を一覧表示します。
pac copilot-studio list-maker-evaluation-test-sets (プレビュー)指定した環境のボットのテスト セットの一覧を取得します。
pac copilot-studio reassign-copilot-agent (プレビュー)ボットの所有者を再割り当てします。
pac copilot-studio run-maker-evaluation-test-set (プレビュー)特定のテスト セットに対してメーカー評価テストの実行をトリガーします。
pac copilot-studio set-bot-as-quarantined (プレビュー)ボットの検疫状態を true に設定します。
pac copilot-studio set-bot-as-unquarantined (プレビュー)ボットの検疫状態を false に設定します。
pac copilot-studio set-connector-consent-bypass (プレビュー)ボットの管理者コネクタの同意バイパス設定を設定します。

pac copilot-studio delete-copilot-agent

(プレビュー)ボットを削除します。

に必要なパラメーター copilot-studio delete-copilot-agent

--bot-id

ボット ID。

の省略可能なパラメーター copilot-studio delete-copilot-agent

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

delete-copilot-agent 発言

Power Platform REST API Bots - Delete Copilot Agent を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio download-agent-channel-manifest

(プレビュー)指定したエージェントとチャネルのチャネル マニフェスト パッケージを zip ファイルとしてダウンロードします。 現時点では、"M365" チャネルのみがサポートされています。

に必要なパラメーター copilot-studio download-agent-channel-manifest

--agent-id

ボット ID。

--channel-name

チャンネル名。 現在サポートされているのは "M365" のみです。

--out-file

ダウンロードしたコンテンツを書き込むローカル ファイル のパス。

の省略可能なパラメーター copilot-studio download-agent-channel-manifest

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--include-agent-schema

ダウンロードしたマニフェスト パッケージにエージェント スキーマを含めるかどうか。

download-agent-channel-manifest 発言

Power Platform REST API エージェント チャネル - エージェント チャネル マニフェストのダウンロードを使用して、このコマンドを呼び出すこともできます。

pac copilot-studio download-licensing-report-file

(プレビュー)生成されたライセンス レポートを gzip 圧縮 CSV ファイルとしてダウンロードします。 レポート操作によって返されるファイル名を、成功状態で使用します。

に必要なパラメーター copilot-studio download-licensing-report-file

--file-name

[成功] 状態のレポート操作によって返されるレポート ファイル名。

--out-file

ダウンロードしたコンテンツを書き込むローカル ファイル のパス。

--report-name

生成されたレポートの名前。

次の値のいずれかを使用します。

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(プレビュー)要求された日付範囲でテナントのCopilot Studio ライセンス レポートの生成を開始します。 生成は非同期的に実行されます。Location ヘッダーの URL をポーリングして状態を確認します。 グローバル、Dynamics 365、または Power Platform 管理者ロールが必要です。

に必要なパラメーター copilot-studio generate-licensing-report

--end-date

レポート範囲の包括的な UTC 終了日。 開始日以降である必要があります。

--report-name

生成するレポートの名前。

次の値のいずれかを使用します。

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

--start-date

レポート範囲の包括的な UTC 開始日。

の省略可能なパラメーター copilot-studio generate-licensing-report

--granularity

ライセンス レポートの粒度。 日次は日付範囲で 1 日に 1 行を返し、Summary は範囲全体に対して 1 つの集計行を返します。

次の値のいずれかを使用します。

  • Daily
  • Summary

pac copilot-studio get-bot-quarantine-status

(プレビュー)ボットの検疫状態を取得します。

に必要なパラメーター copilot-studio get-bot-quarantine-status

--bot-id

ボット ID。

の省略可能なパラメーター copilot-studio get-bot-quarantine-status

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

get-bot-quarantine-status 発言

Power Platform REST API ボット - ボット検疫状態の取得を使用して、このコマンドを呼び出すこともできます。

(プレビュー)ボットの管理者コネクタの同意バイパス設定を取得します。

--bot-id

ボット ID。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

Power Platform REST API ボット - Get Connector Consent Bypass を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio get-licensing-report-operation

(プレビュー)ライセンス レポート生成操作の状態を取得します。 状態が [成功] の場合、応答にはレポート ファイル名が含まれており、Location ヘッダーにはダウンロード URL が含まれます。

に必要なパラメーター copilot-studio get-licensing-report-operation

--operation-id

レポート生成の開始時に Location ヘッダーで返されるレポート操作 ID。

--report-name

生成されるレポートの名前。

次の値のいずれかを使用します。

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio get-maker-evaluation-test-run

(プレビュー)特定のメーカー評価テストの実行の状態と結果を取得します。

に必要なパラメーター copilot-studio get-maker-evaluation-test-run

--bot-id

ボット ID。

--test-run-id

テスト実行 ID。

の省略可能なパラメーター copilot-studio get-maker-evaluation-test-run

--columns

テーブル出力に含める応答プロパティのコンマ区切りのリスト。 完全な応答には --json を使用します。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

get-maker-evaluation-test-run 発言

Power Platform REST API ボット - Get Maker Evaluation Test Run を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio get-maker-evaluation-test-set

(プレビュー)ボットの作成者評価用の特定のテスト セットを取得します。

に必要なパラメーター copilot-studio get-maker-evaluation-test-set

--bot-id

ボット ID。

--test-set-id

テスト セット ID。

の省略可能なパラメーター copilot-studio get-maker-evaluation-test-set

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

get-maker-evaluation-test-set 発言

Power Platform REST API ボット - Get Maker Evaluation Test Set を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio list-maker-evaluation-test-runs

(プレビュー)ボットのすべての Maker 評価テストの実行を一覧表示します。

に必要なパラメーター copilot-studio list-maker-evaluation-test-runs

--bot-id

ボット ID。

の省略可能なパラメーター copilot-studio list-maker-evaluation-test-runs

--columns

テーブル出力に含める応答プロパティのコンマ区切りのリスト。 完全な応答には --json を使用します。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

list-maker-evaluation-test-runs 発言

Power Platform REST API ボット - List Maker Evaluation Test Runs を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio list-maker-evaluation-test-sets

(プレビュー)指定した環境のボットのテスト セットの一覧を取得します。

に必要なパラメーター copilot-studio list-maker-evaluation-test-sets

--bot-id

ボット ID。

の省略可能なパラメーター copilot-studio list-maker-evaluation-test-sets

--columns

テーブル出力に含める応答プロパティのコンマ区切りのリスト。 完全な応答には --json を使用します。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

list-maker-evaluation-test-sets 発言

Power Platform REST API ボット - List Maker Evaluation Test Sets を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio reassign-copilot-agent

(プレビュー)ボットの所有者を再割り当てします。

に必要なパラメーター copilot-studio reassign-copilot-agent

--bot-id

ボット ID。

--new-owner-aad-user-id

新しい所有者Entra ID。

の省略可能なパラメーター copilot-studio reassign-copilot-agent

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

reassign-copilot-agent 発言

Power Platform REST API ボット - Copilot エージェントの再割り当てを使用して、このコマンドを呼び出すこともできます。

pac copilot-studio run-maker-evaluation-test-set

(プレビュー)特定のテスト セットに対してメーカー評価テストの実行をトリガーします。

に必要なパラメーター copilot-studio run-maker-evaluation-test-set

--bot-id

ボット ID。

--test-set-id

テスト セット ID。

の省略可能なパラメーター copilot-studio run-maker-evaluation-test-set

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--evaluation-run-name

評価実行の名前。

--mcs-connection-id

評価実行の実行に使用される MCS コネクタの接続 ID。匿名実行の場合は空のままにします。

--run-on-published-bot

発行されたボット インスタンスで操作を実行するかどうかを示します。 false に設定すると、下書きボット インスタンスで操作が実行されます。

--tools-connections

評価実行の実行に使用されるツール接続。 これは、各ツールに使用する必要がある対応するユーザー接続と共に、ツールの一覧です。 値を JSON 配列として指定します。

run-maker-evaluation-test-set 発言

Power Platform REST API ボット - Run Maker Evaluation Test Set を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio set-bot-as-quarantined

(プレビュー)ボットの検疫状態を true に設定します。

に必要なパラメーター copilot-studio set-bot-as-quarantined

--bot-id

ボット ID。

の省略可能なパラメーター copilot-studio set-bot-as-quarantined

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

set-bot-as-quarantined 発言

Power Platform REST API Bots - Set Bot As Quarantined を使用して、このコマンドを呼び出すこともできます。

pac copilot-studio set-bot-as-unquarantined

(プレビュー)ボットの検疫状態を false に設定します。

に必要なパラメーター copilot-studio set-bot-as-unquarantined

--bot-id

ボット ID。

の省略可能なパラメーター copilot-studio set-bot-as-unquarantined

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

set-bot-as-unquarantined 発言

Power Platform REST API ボット - Set Bot As Unquarantined を使用して、このコマンドを呼び出すこともできます。

(プレビュー)ボットの管理者コネクタの同意バイパス設定を設定します。

ボットの管理者コネクタの同意バイパスを有効にするかどうかを示します。

--bot-id

ボット ID。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

Power Platform REST API ボット - Set Connector Consent Bypass を使用して、このコマンドを呼び出すこともできます。

関連項目

Microsoft Power Platform CLI コマンド グループ
Microsoft Power Platform CLIの概要