通过

pac 连接器

用于使用 Power Platform 连接器的命令

指令

Command Description
pac 连接器创建 在 Dataverse 的 Connector 表中创建新行。
pac 连接器下载 下载连接器的 OpenApiDefinition 和 API 属性文件
pac 连接器 init 初始化连接器的新 API 属性文件。
pac 连接器列表 列出 Dataverse 中注册的连接器。
pac 连接器更新 更新 Dataverse 中的连接器实体。

pac 连接器创建

在 Dataverse 的 Connector 表中创建新行。

例子

以下示例演示了命令的使用 pac connector create 。

在当前环境中创建基本连接器

此示例在当前活动身份验证配置文件的环境中创建连接器。

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json

在指定环境中创建基本连接器

此示例在指定环境中创建连接器。

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json
  --environment 00000000-0000-0000-0000-000000000000

连接器创建的可选参数

--api-definition-file -df

读取连接器的 OpenApiDefinition 的文件名和路径。

--api-properties-file -pf

读取连接器的 API 属性文件的文件名和路径。

--environment -env

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

--icon-file -if

文件名和路径以及图标 .png 文件。

--script-file -sf

脚本 .csx 文件的文件名和路径。

--settings-file

文件名和路径连接器设置文件。

--solution-unique-name -sol

要向其添加连接器的解决方案的唯一名称

pac 连接器下载

下载连接器的 OpenApiDefinition 和 API 属性文件

例子

以下示例演示了命令的使用 pac connector download 。

基本连接器下载

此示例将指定的连接器下载到当前目录。

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000

从指定环境下载基本连接器

此示例将指定连接器从指定环境下载到当前目录。

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000

从指定环境下载到指定目录的基本连接器

此示例将指定连接器从指定环境下载到指定的目录。

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000 `
  --outputDirectory "contoso_Connector"

连接器下载所需的参数

--connector-id -id

连接器的 ID

注意：连接器 ID 必须是有效的 Guid。

连接器下载的可选参数

--environment -env

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

--outputDirectory -o

输出目录

pac 连接器 init

初始化连接器的新 API 属性文件。

Example

以下示例演示了命令的使用 pac connector init 。

连接器 init，其中包含用于Microsoft Entra ID OAuth 身份验证的输出目录和连接模板

此示例初始化当前目录中的连接器。

pac connector init `
  --connection-template "OAuthAAD" `
  --generate-script-file `
  --generate-settings-file `
  --outputDirectory "contoso_Connector"

连接器 init 的可选参数

--connection-template -ct

使用指定的模板生成初始连接参数集。

使用以下值之一：

  • NoAuth
  • BasicAuth
  • ApiKey
  • OAuthGeneric
  • OAuthAAD

--generate-script-file

生成初始连接器脚本文件

此参数不需要任何值。 这是一个开关。

--generate-settings-file

生成初始连接器设置文件

此参数不需要任何值。 这是一个开关。

--outputDirectory -o

输出目录

pac 连接器列表

列出 Dataverse 中注册的连接器。

例子

以下示例演示了命令的使用 pac connector list 。

列出当前环境中的连接器

此示例列出了当前活动身份验证配置文件环境中的所有连接器。

pac connector list

列出指定环境中的连接器

此示例列出指定环境中的所有连接器。

pac connector list `
  --environment 00000000-0000-0000-0000-000000000000

连接器列表的可选参数

--environment -env

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

--json

以 JSON 格式字符串的形式返回命令的输出。

注解

仅显示解决方案感知连接器。 当连接器不在此命令的响应中时，这可能是因为连接器无法识别解决方案。

pac 连接器更新

更新 Dataverse 中的连接器实体。

例子

以下示例演示了命令的使用 pac connector update 。

当前环境中的基本连接器更新

此示例更新当前活动身份验证配置文件环境中的连接器。

pac connector update `
  --api-definition-file ./apiDefinition.json

指定环境中的基本连接器更新

此示例更新指定环境中的连接器。

pac connector update `
  --api-definition-file ./apiDefinition.json `
  --environment 00000000-0000-0000-0000-000000000000

连接器更新的可选参数

--api-definition-file -df

读取连接器的 OpenApiDefinition 的文件名和路径。

--api-properties-file -pf

读取连接器的 API 属性文件的文件名和路径。

--connector-id -id

连接器的 ID

注意：连接器 ID 必须是有效的 Guid。

--environment -env

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

--icon-file -if

文件名和路径以及图标 .png 文件。

--script-file -sf

脚本 .csx 文件的文件名和路径。

--settings-file

文件名和路径连接器设置文件。

--solution-unique-name -sol

要向其添加连接器的解决方案的唯一名称

另请参阅

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