pac コネクタ

  • [アーティクル]

Power Platform コネクタを使用するためのコマンド

コマンド

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

注: コネクタIDは有効なGUIDである必要があります。

コネクタのダウンロードで使用するオプションのパラメーター

--environment-env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--outputDirectory-o

出力ディレクトリ

pac コネクタ init

コネクタの新しい API プロパティ ファイルを初期化します。

例

次に pac connector init コマンドの使用例を示します。

ID認証用の出力ディレクトリと接続テンプレートを使用したコネクタの初期化 Microsoft Entra 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の概要