pac コネクタ

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

コマンド

command	Description
pac コネクタの作成	Dataverse のコネクタ テーブルに新しい行を作成します。
pac コネクタのダウンロード	コネクタの OpenApiDefinition および API プロパティ ファイルをダウンロードする
pac コネクタ init	コネクタの新しい 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 コマンドの使用例を示します。

Microsoft Entra ID OAuth 認証用の出力ディレクトリと接続テンプレートを使用したコネクタ初期化

この例では、現在のディレクトリでコネクタを初期化します。

pac connector init `
  --connection-template "OAuthAAD" `
  --generate-script-file "contoso_script_file" `
  --generate-settings-file "contoso_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 の概要