（預告）管理 Copilot Studio 代理人並匯出租戶授權報告。
Commands
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 機器人 - 刪除 Copilot 代理來呼叫此指令。
pac copilot-studio download-agent-channel-manifest
（預告）下載指定代理的通道清單套件及通道的壓縮檔。 目前僅支援「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
產生的報告名稱。
使用下列其中一個值：
BillingDetailsPerEnvironmentFeatureDetailsPerResource
pac copilot-studio generate-licensing-report
（預告）開始為你的租戶在請求日期範圍內產生 Copilot Studio 授權報告。 生成是非同步的;在 Location 標頭中輪詢該網址以取得狀態。 需要具備全域管理員、Dynamics 365 或 Power Platform 管理員角色。
所需參數 copilot-studio generate-licensing-report
--end-date
包含報告範圍的UTC結束日期。 必須是在開始日期當天或之後。
--report-name
要產生的報告名稱。
使用下列其中一個值：
BillingDetailsPerEnvironmentFeatureDetailsPerResource
--start-date
包含報告範圍的UTC起始日期。
可選參數 copilot-studio generate-licensing-report
--granularity
授權報告的細緻度。 Daily 每天回傳日期範圍內的一列，Summary 則回傳整個範圍的單一摘要列。
使用下列其中一個值：
DailySummary
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 機器人 - 取得機器人隔離狀態來呼叫此指令。
pac copilot-studio get-connector-consent-bypass
（預告）取得機器人管理員連接器同意繞過設定。
所需參數 copilot-studio get-connector-consent-bypass
--bot-id
機器人 ID。
可選參數 copilot-studio get-connector-consent-bypass
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定，則會使用為目前驗證設定檔選取的作用中組織。
get-connector-consent-bypass 備註
你也可以使用 Power Platform REST API 機器人 - 取得連接器同意繞過（Get Connector Consent Bypass）來呼叫此指令。
pac copilot-studio get-licensing-report-operation
（預告）取得授權報告產生作業的狀態。 當狀態為 Succeeded（成功）時，回應會包含報告檔案名稱，Location 標頭則包含下載 URL。
所需參數 copilot-studio get-licensing-report-operation
--operation-id
報告操作 ID 會在報表產生開始時，在 Location 標頭中回傳。
--report-name
正在產生的報告名稱。
使用下列其中一個值：
BillingDetailsPerEnvironmentFeatureDetailsPerResource
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
（預告）列出所有機器人的製作者評估測試執行。
所需參數 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 評估測試執行來呼叫此指令。
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 評估測試集來呼叫此指令。
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
（預告）針對特定測試集觸發 maker 評估測試。
所需參數 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 機器人 - 設定機器人為隔離者來呼叫此指令。
pac copilot-studio set-bot-as-unquarantined
（預告）將機器人的隔離狀態設為假。
所需參數 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）來呼叫此指令。
pac copilot-studio set-connector-consent-bypass
（預告）為機器人設定管理員連接器同意繞過設定。
所需參數 copilot-studio set-connector-consent-bypass
--admin-consent-bypass
指示是否啟用機器人的管理員連接器同意繞過。
--bot-id
機器人 ID。
可選參數 copilot-studio set-connector-consent-bypass
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定，則會使用為目前驗證設定檔選取的作用中組織。
set-connector-consent-bypass 備註
你也可以使用 Power Platform REST API 機器人 - 設定連接器同意繞過來（Set Connector Consent Bypass）來呼叫此指令。
另請參閱
Microsoft Power Platform CLI 指令群組
Microsoft Power Platform CLI 概述