(预览版)管理Copilot Studio代理和导出租户许可报告。
指令
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
(预览版)将指定代理和通道的通道清单包下载为 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
生成的报表的名称。
使用以下值之一:
BillingDetailsPerEnvironmentFeatureDetailsPerResource
pac copilot-studio generate-licensing-report
(预览版)开始根据请求的日期范围为租户生成Copilot Studio许可报告。 生成以异步方式运行;在 Location 标头中轮询 URL 以获取状态。 需要全局、Dynamics 365或 Power Platform 管理员角色。
所需的参数 copilot-studio generate-licensing-report
--end-date
报表范围的包含 UTC 结束日期。 必须位于开始日期或之后。
--report-name
要生成的报表的名称。
使用以下值之一:
BillingDetailsPerEnvironmentFeatureDetailsPerResource
--start-date
报表范围的非独占 UTC 开始日期。
可选参数 copilot-studio generate-licensing-report
--granularity
许可报告的粒度。 每日返回日期范围内的每天一行,“摘要”返回整个范围的单个汇总行。
使用以下值之一:
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 机器人调用此命令 - 获取连接器许可绕过。
pac copilot-studio get-licensing-report-operation
(预览版)获取许可报表生成操作的状态。 当状态为“成功”时,响应包括报表文件名,位置标头包含下载 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 机器人 - 获取 Maker 评估测试运行来调用此命令。
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 机器人 - 获取 Maker 评估测试集调用此命令。
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 机器人 - 列出 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
(预览版)触发特定测试集的创建者评估测试运行。
所需的参数 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 机器人 - 运行 Maker 评估测试集调用此命令。
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
(预览版)将机器人的隔离状态设置为 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 机器人调用此命令 - 将机器人设置为未隔离。
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 机器人调用此命令 - 设置连接器许可绕过。
另见
Microsoft Power Platform CLI 命令组
Microsoft Power Platform CLI 概述