pac copilot-studio

(预览版)管理Copilot Studio代理和导出租户许可报告。

指令

Command 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 (预览版)获取许可报表生成操作的状态。 当状态为“成功”时,响应包括报表文件名,位置标头包含下载 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 (预览版)列出机器人的所有制造商评估测试运行。
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 机器人调用此命令 - 删除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

生成的报表的名称。

使用以下值之一:

  • 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

许可报告的粒度。 每日返回日期范围内的每天一行,“摘要”返回整个范围的单个汇总行。

使用以下值之一:

  • 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 机器人调用此命令 - 获取连接器许可绕过。

pac copilot-studio get-licensing-report-operation

(预览版)获取许可报表生成操作的状态。 当状态为“成功”时,响应包括报表文件名,位置标头包含下载 URL。

所需的参数 copilot-studio get-licensing-report-operation

--operation-id

报表操作 ID,在报表生成启动时在 Location 标头中返回。

--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 机器人 - 获取 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 机器人调用此命令 - 将机器人设置为未隔离。

(预览版)为机器人设置管理员连接器许可绕过设置。

指示是否为机器人启用管理员连接器许可绕过。

--bot-id

机器人 ID。

--environment -env

指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。

还可以使用 Power Platform REST API 机器人调用此命令 - 设置连接器许可绕过。

另见

Microsoft Power Platform CLI 命令组
Microsoft Power Platform CLI 概述