共用方式為

PAC 連接器

使用 Power Platform 連接器的命令

Commands

Command Description
PAC 連接器建立 在 Dataverse 的連接器資料表中建立新資料列。
PAC 連接器下載 下載連接器的 OpenApiDefinition 和 API 屬性檔案
pac 連接器初始化 初始化連接器的新 API 內容檔案。
PAC 連接器清單 列出在 Dataverse 中註冊的連接器。
PAC 連接器更新 更新 Dataverse 中的連接器實體。

PAC 連接器建立

在 Dataverse 的連接器資料表中建立新資料列。

範例

下列範例顯示命令的 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

附註： 連接器識別碼必須是有效的 Guid。

連接器下載的選用參數

--environment -env

指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定，則會使用為目前驗證設定檔選取的作用中組織。

--outputDirectory -o

輸出目錄

pac 連接器初始化

初始化連接器的新 API 內容檔案。

Example

下列範例顯示命令的 pac connector 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

附註： 連接器識別碼必須是有效的 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 概觀

  • Last updated on