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
指定したテンプレートで設定された初期接続パラメーターを生成します。
次の値のいずれかを使用します。
NoAuthBasicAuthApiKeyOAuthGenericOAuthAAD
--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の概要