この Power Apps CLI コマンド リファレンスを使用して、コード アプリを作成、開発、接続、発行するためのコマンドPower Apps簡単に見つけることができます。 CLI では、次の形式でグループ化されたコマンドが使用されます。
pa <command-group> <command>
コマンド グループは次のとおりです。
| コマンドグループ | Description |
|---|---|
pa app |
コード アプリを作成、実行、接続、発行します。 |
pa auth |
サインインしてアカウントを管理します。 |
pa connection |
接続を作成して管理し、そのリソースを検出します。 |
pa connector |
Power Platform 環境で使用できるコネクタを検索します。 |
pa solution |
Power Platform 環境で使用できるソリューションを見つけます。 |
pa telemetry |
CLI テレメトリ設定を管理します。 |
グローバル オプション
ターミナルにヘルプを表示するには、任意のレベルで --help を使用します。
pa --help
pa app --help
pa app init --help
--versionを使用して、インストールされている Power Apps CLI のバージョンを表示します。
pa --version
cli コマンドのPower Apps
次のコマンドを使用できます。
| 命令 | Description |
|---|---|
pa app add data-source |
コード アプリにコネクタまたは表形式のデータ ソースを追加します。 |
pa app add dataverse-api |
Dataverse アクションまたは関数をコード アプリに追加します。 |
pa app add flow |
コード アプリにPower Automate フローを追加します。 |
pa app find-dataverse-api |
現在の環境で Dataverse のアクションと関数を検索します。 |
pa app get-settings |
現在のアプリ設定を表示します。 |
pa app init |
現在のディレクトリでコード アプリを初期化します。 |
pa app list |
現在の環境のコード アプリを一覧表示します。 |
pa app list-environment-variables |
コード アプリで使用できる環境変数を一覧表示します。 |
pa app list-flows |
現在の環境のソリューション対応Power Automate フローを一覧表示します。 |
pa app push |
新しいバージョンのコード アプリをPower Appsに発行します。 |
pa app refresh data-source |
データ ソースの生成されたファイルを更新します。 |
pa app remove data-source |
コード アプリからデータ ソースを削除します。 |
pa app remove flow |
コード アプリからPower Automate フローを削除します。 |
pa app run |
コード アプリの Power Apps ローカル ホストを起動します。 |
pa app set-setting |
アプリの設定を更新します。 |
pa app share |
コード アプリをユーザーまたはサービス プリンシパルと共有します。 |
pa auth login |
システム ブラウザーを使用してサインインします。 |
pa auth logout |
サインアウトし、保存されている認証情報を削除します。 |
pa auth status |
サインインしているアカウントを表示し、アクティブなアカウントを識別します。 |
pa auth switch |
アクティブなアカウントを変更します。 |
pa connection create |
コネクタの接続を作成します。 |
pa connection list |
現在の環境の接続を一覧表示します。 |
pa connection list-datasets |
接続を介して使用可能なデータセットを一覧表示します。 |
pa connection list-procedures |
データセットで使用できる SQL ストアド プロシージャを一覧表示します。 |
pa connection list-references |
ソリューション内の接続参照を一覧表示します。 |
pa connection list-tables |
データセットで使用できるテーブルを一覧表示します。 |
pa connector list |
現在の Power Platform 環境で使用できるコネクタを一覧表示します。 |
pa solution list |
現在の環境のソリューションを一覧表示します。 |
pa telemetry disable |
テレメトリ収集を無効にします。 |
pa telemetry enable |
テレメトリ収集を有効にします。 |
pa telemetry status |
現在のテレメトリ設定を表示します。 |
pa app add data-source
コード アプリにコネクタまたは表形式のデータ ソースを追加します。
pa app add data-source --connector <connector-id> [options]
pa app add data-source パラメーター
| パラメーター | Description |
|---|---|
--connector |
コネクタ識別子 ( shared_office365usersなど)、またはコネクタの表示名 ( "Office 365 ユーザー"など)。 表示名が複数のコネクタと一致する場合、コマンドは一致するコネクタ識別子を一覧表示して、1 つを指定できるようにします。 |
--as |
コネクタを table または action データ ソースとして追加するかどうか。 このパラメーターは、テーブルとアクション (SharePointやSQL Serverなど) の両方をサポートするコネクタと共に使用します。 詳細については、 pa app add data-source 解説を参照してください。 |
--connection-id |
データ ソースに使用する接続 ID。 |
--connection-ref |
接続参照の論理名 ( cr123_sharedsharepointonline_1a2b3など)。 |
--solution-id |
接続参照を含むソリューション。 |
--dataset |
表形式データ ソースのデータセット。 |
--table |
追加するテーブル。 同じコネクタ、接続、データセットから複数のテーブルを追加するには、このパラメーターを繰り返します。 Native Dataverse では、コマンドごとに 1 つのテーブルがサポートされます。 |
--org-url |
ネイティブの Dataverse テーブル メタデータの取得に使用される Dataverse 組織の URL。 対話型モードでは、コマンド オプションまたは環境変数として指定しない場合、コマンドによってこの値の入力が求められます。 |
--procedure |
追加する SQL ストアド プロシージャ。 |
これらのパラメーターには、対応する ソリューション、コネクタ、データ ソースの 環境変数があります。
pa app add data-source 発言
1 つのコマンドに複数のコネクタ テーブルを追加するには、テーブルごとに --table を繰り返します。 テーブルでは、同じコネクタ、接続、データセットを使用する必要があります。 このコマンドは、重複するテーブル識別子を 1 回だけ追加します。 コマンドごとに含めることができるネイティブ Dataverse テーブルまたは SQL ストアド プロシージャは 1 つだけです。
テーブル固有のメタデータ、検証、またはスキーマ書き込み操作が失敗した場合でも、コマンドは有効なテーブルを追加します。 順序付けられた succeeded と failed 結果を報告し、テーブルが失敗した場合は 0 以外の終了コードを返します。 再試行する前に結果を確認します。
SharePointやSQL Serverなどの一部のコネクタでは、テーブルとアクションの両方がサポートされています。 これらのコネクタの場合は、追加する内容を指定します。
- テーブルまたは SQL ストアド プロシージャを追加するには、
--as tableを使用するか、--tableまたは--procedureを含めます。 - コネクタのアクションを追加するには、
--as actionを使用します。--dataset、--table、または--procedureで--as actionを使用することはできません。
追加する内容を指定しない場合、コマンドは対話型ターミナルで テーブルの追加 を要求します。 非対話型モードでは、 --asを指定するまでコマンドは失敗します。 Office 365 ユーザーなどのアクションのみをサポートするコネクタは、--asを必要とせず、--as tableをサポートしません。 Dataverse のアクションまたは関数を追加するには、--as actionではなくpa app add dataverse-apiを使用します。
対話型ターミナルでは、コマンド オプションまたは環境変数として指定しない必要な値の入力を求められます。 プロンプトは、データ ソースの種類によって異なります。
ネイティブ Dataverse の場合:
-
--connectorを指定しない場合、コマンドはコネクタ ID を要求します。 - このコマンドは、テーブルの論理名を要求します。
- 指定されていない場合、コマンドは Dataverse 組織の URL を要求します。
Native Dataverse では、接続 ID、接続参照、またはデータセットは使用されません。
コネクタに基づくデータ ソースの場合:
コネクタとデータ ソースの種類を選択する
-
--connectorを指定しない場合、コマンドはコネクタ ID を要求します。 - コネクタがテーブルとアクションの両方をサポートしていて、何も追加する内容が決まっていない場合、コマンドはテーブルの追加を求めます。
接続を選択する
このコマンドは、 接続 ID の代わりに接続参照を使用していますか? 接続 ID または接続参照を指定する場合、この質問はスキップされます。
- [はい] を選択すると、コマンドによって接続参照の論理名が求められます。
- [いいえ] を選択すると、コネクタの接続が一覧表示されます。 ( 手動で入力...) を選択して、一覧にない接続 ID を入力します。
データを選択する
アクションを追加する場合、このコマンドはストアド プロシージャ、データセット、およびテーブル プロンプトをスキップします。
テーブルまたはストアド プロシージャを追加する場合:
- SQL Serverの場合、このコマンドはストアド プロシージャを追加するかどうかを確認します。 ある場合は、ストアド プロシージャ名を要求します。
- このコマンドは、接続を介して使用可能なデータセットを一覧表示します。 (手動で入力...) を選択して、一覧にないデータセットを入力します。
- ストアド プロシージャを追加する場合を除き、このコマンドを実行すると、データセット内のテーブルの検索可能な一覧が開きます。 複数のテーブルを選択できます。
接続参照を使用する場合、データセットとテーブルの一覧は、参照が指す接続から取得されます。
pa app add data-source の例
プロンプトに応答してデータ ソースを追加します。
pa app add data-source
ネイティブ Dataverse テーブルを追加します。
pa app add data-source --connector dataverse --table account
テーブルもサポートするコネクタのアクションを追加します。
pa app add data-source \
--connector shared_sharepointonline \
--connection-id <connection-id> \
--as action
コネクタの表示名を使用してSharePoint listを追加します。
pa app add data-source \
--connector "SharePoint" \
--connection-id <connection-id> \
--dataset <site-url> \
--table <list-name>
同じデータセットから複数の SQL テーブルを追加します。
pa app add data-source \
--connector shared_sql \
--connection-id <connection-id> \
--dataset <server-name,database-name> \
--table "[dbo].[Customers]" \
--table "[dbo].[Orders]"
接続参照を使用してテーブルを追加し、コマンド プロンプトが表示されたらデータセットとテーブルを選択します。
pa app add data-source \
--connector shared_sharepointonline \
--connection-ref <connection-reference-logical-name> \
--solution-id <solution-id> \
--as table
pa app add dataverse-api
Dataverse アクションまたは関数をコード アプリに追加します。
pa app add dataverse-api --api-name <operation-name>
pa app add dataverse-api パラメーター
| パラメーター | Description |
|---|---|
--api-name |
追加する Dataverse アクションまたは関数の名前。 |
PA_CLI_DATAVERSE_API_NAME は、 --api-name パラメーターの対応する環境変数です。
詳細情報:
pa app add flow
コード アプリにPower Automate フローを追加します。
pa app add flow --flow-id <flow-id>
pa app add flow パラメーター
| パラメーター | Description |
|---|---|
--flow-id |
追加するPower Automate フローの ID。 |
PA_CLI_FLOW_ID は、 --flow-id パラメーターの対応する環境変数です。
コマンド:
- フローの OpenAPI 定義をダウンロードします。
- 厳密に型指定された TypeScript モデルとサービスを生成します。
- フローとその接続参照を
power.config.jsonに追加します。
フロー定義が変更された場合は、このコマンドをもう一度実行して、最新バージョンのコードを再生成します。
Important
pa app add flowを実行するユーザーは、フローとその基になる接続にアクセスできる必要があります。 ユーザーが必要な接続にアクセスできない場合、コマンドは失敗します。
このコマンドを使用するシナリオの詳細については、以下を参照してください。
- Power Automate フローを追加した場合の動作について説明します
- Power Automate フローを更新する方法について説明します
- Power Automate フローの制限事項と考慮事項を確認する
pa app find-dataverse-api
現在の環境で Dataverse のアクションと関数を検索します。
pa app find-dataverse-api --search <operation-name> [--json]
pa app find-dataverse-api パラメーター
| パラメーター | Description |
|---|---|
--search |
検索する操作名。 |
--json |
結果を JSON として返します。 |
これらのパラメーターは、Dataverse API と Power Automate フロー環境変数に対応します。
使用可能な Dataverse 操作を見つける方法について説明します。
pa app get-settings
コード アプリの現在の設定を表示します。
pa app get-settings [--json]
pa app get-settings パラメーター
| パラメーター | Description |
|---|---|
--json |
アプリ設定を JSON として返します。 |
power.config.json ファイルを含む初期化されたコード アプリ プロジェクトからこのコマンドを実行します。
pa app init
現在のディレクトリ内のコード アプリを初期化します。
pa app init [--display-name <name>] [--environment-id <environment-id>]
pa app init パラメーター
| パラメーター | Description |
|---|---|
--display-name |
コード アプリの表示名。 |
--environment-id |
コード アプリの Power Platform 環境。 |
--description |
コード アプリの説明。 |
--build-path |
コンパイル済みのアプリ資産を含むディレクトリ。 |
--file-entry-point |
ビルド出力の HTML エントリ ポイント。 |
--app-type |
アプリの種類。 有効値は CodeApp または MobileApp です。 |
--app-url |
ローカルで実行されているコード アプリの URL。 |
--cloud |
Power Platform クラウド インスタンス。 |
これらのパラメーターには、対応する アプリ初期化 環境変数があります。
このコマンドを使用できるシナリオの詳細については、以下を参照してください。
- Dataverse アクションまたは関数を追加するための前提条件を確認する
- Power Automate フローを追加するための前提条件を確認する
- コード アプリを初期化する方法について説明します
- コード アプリを初期化するときのサインインのしくみについて説明します
pa app list
現在の環境のコード アプリを一覧表示します。
pa app list
pa app list-environment-variables
コード アプリで使用できる環境変数を一覧表示します。
pa app list-environment-variables
pa app list-flows
現在の環境のソリューション対応Power Automate フローを一覧表示します。
pa app list-flows [--search <term>]
例:
pa app list-flows
Name Status Modified On Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow Started 2026-01-15 a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification Started 2026-02-01 b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2
Total flows: 2
pa app list-flows パラメーター
| パラメーター | Description |
|---|---|
--search |
名前でフローをフィルター処理します。 |
PA_CLI_FLOW_SEARCH は、 --search パラメーターの対応する環境変数です。
pa app push
コード アプリの新しいバージョンをPower Appsに発行します。
pa app push [--solution-id <solution-id>]
pa app push パラメーター
| パラメーター | Description |
|---|---|
--solution-id |
コード アプリを追加するソリューションの ID。 |
--non-interactive |
非対話型でアプリを発行します。 サービス プリンシパルを使用してアプリを発行する方法について説明します。 |
--solution-id パラメーターを使用して環境変数としてPA_CLI_SOLUTION_IDを使用します。
Power Apps CLI を使用してコード アプリを作成する方法について説明します。
pa app refresh data-source
データ ソースの生成されたファイルを更新します。
pa app refresh data-source --name <data-source-name>
pa app refresh data-source パラメーター
| パラメーター | Description |
|---|---|
--name |
更新するデータ ソースの名前。 |
pa app remove data-source
コード アプリからデータ ソースを削除します。
pa app remove data-source --connector <connector-id> --name <data-source-name> [--force]
pa app remove data-source パラメーター
| パラメーター | Description |
|---|---|
--connector |
データ ソースのコネクタ識別子。 |
--name |
削除するデータ ソースの名前。 |
--force |
確認を求めずにデータ ソースを削除します。 |
pa app remove flow
コード アプリからPower Automate フローを削除します。
pa app remove flow [--flow-name <name> | --flow-id <flow-id>] [--force]
pa app remove flow パラメーター
| パラメーター | Description |
|---|---|
--flow-name |
削除するPower Automate フローの名前。 |
--flow-id |
削除するPower Automate フローの ID。 |
--force |
確認を求めずにフローを削除します。 |
PA_CLI_FLOW_DATA_SOURCE_NAME と PA_CLI_REMOVE_FLOW_ID は、これらのパラメーターで使用する対応する環境変数です。
フローを削除する方法について説明します。
pa app run
コード アプリのPower Appsローカル ホストを開始します。
pa app run [--port <port>] [--local-app-url <url>]
pa app run パラメーター
| パラメーター | Description |
|---|---|
--port |
ローカル ホストのポート。 |
--local-app-url |
ローカルで実行されているコード アプリの URL。 |
これらのパラメーターには、対応する [アプリの実行] 環境変数があります。
pa app set-setting
コード アプリの 1 つ以上の設定を更新します。
pa app set-setting --show-header <true|false> [--json]
pa app set-setting パラメーター
| パラメーター | Description |
|---|---|
--show-header |
アプリ ヘッダーを表示または非表示にします。 有効値は true または false です。 |
--json |
更新されたアプリ設定を JSON として返します。 |
power.config.json ファイルを含む初期化されたコード アプリ プロジェクトからこのコマンドを実行します。 このコマンドは、power.config.jsonでappSettingsする設定を書き込みます。
pa app pushを実行して、プレーヤーが実行時に設定を適用するように設定を発行します。
pa app share
コード アプリをユーザーまたはサービス プリンシパルと共有します。
pa app share --principal <principal> [--access play|edit]
pa app share パラメーター
| パラメーター | Description |
|---|---|
--principal |
共有するユーザーまたはサービス プリンシパルのコンマ区切りの電子メール アドレスまたはMicrosoft Entraオブジェクト ID。 |
--access |
付与するアクセス レベル: play (既定) または edit。 |
これらのパラメーターには、対応する Share アプリ 環境変数があります。
pa app share 発言
コード アプリは既に発行済みで、成功した pa app push コマンドのアプリ ID を持っている必要があります。 サービス プリンシパルがeditを実行する必要があるときに、pa app pushアクセス権を付与します。
サービス プリンシパルと共有する場合は、アプリ登録オブジェクト ID ではなく、エンタープライズ アプリケーション オブジェクト ID を使用します。
pa auth login
システム ブラウザーを使用してサインインします。
pa auth login
サインイン ページにアカウントを事前入力するには、次の値を使用します。
pa auth login --account user@contoso.com
pa auth login パラメーター
| パラメーター | Description |
|---|---|
--account |
サインイン ページに事前入力するアカウント。 |
PA_CLI_ACCOUNT は、 --account パラメーターの対応する環境変数です。
pa auth logout
サインアウトし、保存された認証情報を削除します。
pa auth logout
Note
このコマンドは、 すべての アカウントからサインアウトします。 1 つのアカウントからサインアウトすることはできません。 アクティブなアカウントを変更するには、代わりに pa auth switch を使用します。
pa auth status
サインインしているアカウントを表示し、アクティブなアカウントを識別します。
認証の状態を JSON として表示するには、次を使用します。
pa auth status --json
pa auth status パラメーター
| パラメーター | Description |
|---|---|
--json |
認証状態を JSON として返します。 |
pa auth switch
アクティブなアカウントを変更します。
pa auth switch --account user@contoso.com
pa auth switch パラメーター
| パラメーター | Description |
|---|---|
--account |
アクティブにするアカウント。 |
PA_CLI_ACCOUNT は、 --account パラメーターの対応する環境変数です。
このコマンドを使用できる場合の詳細については、以下を参照してください。
pa connection create
コネクタの接続を作成します。
pa connection create --connector <connector-id> [--display-name <name>] [--json]
pa connection create パラメーター
| パラメーター | Alias | 必須 | Description |
|---|---|---|---|
--connector |
- | はい | コネクタ識別子 ( shared_office365 や shared_teamsなど)。 |
--display-name |
-n |
いいえ | 接続の表示名。 名前を指定しない場合、CLI では既定の名前が使用されます。 |
--json |
- | いいえ | 結果を JSON として返します。 |
pa connection create の例
Office 365 Outlook接続を作成します。
pa connection create --connector shared_office365
カスタム表示名を使用してMicrosoft Teams接続を作成します。
pa connection create --connector shared_teams --display-name "My Teams"
接続を作成し、結果を JSON として返します。
pa connection create --connector shared_office365 --json
pa connection create出力
コマンドが成功すると、接続 ID が返されます。 コネクタをデータ ソースとしてコード アプリに追加するときは、接続 ID を使用します。
Power Apps CLI から接続を作成する方法について説明します
pa connection list
現在の環境の接続を一覧表示します。
pa connection list [--search <term>] [--json]
pa connection list パラメーター
| パラメーター | Description |
|---|---|
--search |
名前で接続をフィルター処理します。 |
--json |
結果を JSON として返します。 |
これらのパラメーターには、対応する ソリューション、コネクタ、データ ソースの 環境変数があります。
pa connection list-datasets
接続を介して使用できるデータセットを一覧表示します。
pa connection list-datasets --connector <connector-id> [--connection-id <connection-id>]
pa connection list-datasets パラメーター
| パラメーター | Description |
|---|---|
--connector |
コネクタ識別子。 |
--connection-id |
データセットを一覧表示するときに使用する接続 ID。 |
pa connection list-procedures
データセットで使用できる SQL ストアド プロシージャを一覧表示します。
pa connection list-procedures --connection-id <connection-id> --dataset <dataset>
pa connection list-procedures パラメーター
| パラメーター | Description |
|---|---|
--connection-id |
ストアド プロシージャを一覧表示するときに使用する接続 ID。 |
--dataset |
ストアド プロシージャを含むデータセット。 |
pa connection list-references
ソリューション内の接続参照を一覧表示します。
pa connection list-references --solution-id <solution-id>
pa connection list-references パラメーター
| パラメーター | Description |
|---|---|
--solution-id |
接続参照を含むソリューションの ID。 |
--solution-id パラメーターでPA_CLI_SOLUTION_IDを使用します。
pa connection list-tables
データセットで使用できるテーブルを一覧表示します。
pa connection list-tables --connector <connector-id> [--connection-id <connection-id>] [--dataset <dataset>]
pa connection list-tables パラメーター
| パラメーター | Description |
|---|---|
--connector |
コネクタ識別子。 |
--connection-id |
テーブルを一覧表示するときに使用する接続 ID。 |
--dataset |
テーブルを含むデータセット。 |
pa connector list
現在の Power Platform 環境で使用できるコネクタを一覧表示します。
pa connector list [--search <term>] [--json]
pa connector list パラメーター
| パラメーター | Description |
|---|---|
--search |
名前または表示名でコネクタをフィルター処理します。 |
--json |
コネクタの完全な一覧を JSON として返します。 |
PA_CLI_CONNECTOR_SEARCH は、 --search パラメーターで使用する対応する環境変数です。
pa connector list出力
対話型ターミナルでは、結果が 20 行のページで表示されます。
Enter キーを押して次のページを表示します。
Esc キーまたは Q キーを押して終了します。 出力をリダイレクトするか、 --jsonを含めると、コマンドは完全なリストを返します。
既定では、コマンドは次の列を含むテーブルを返します。
| Column | Description |
|---|---|
| 表示される名前 | コネクタの表示名 (Office 365 Outlookなど)。 |
| Connector | コネクタ識別子 ( shared_office365など)。 この値は、--connectorの pa connection create オプションと共に使用します。 |
--json パラメーターを使用すると、JSON 出力には次のフィールドが含まれます。
| フィールド | Description |
|---|---|
id |
コネクタ ID。 |
name |
コネクタ識別子 ( shared_office365など)。 |
displayName |
コネクタの表示名。 |
description |
コネクタの説明。 |
isTabular |
コネクタが表形式のデータ操作をサポートしているかどうかを示します。 |
pa connector list の例
使用可能なすべてのコネクタを一覧表示します。
pa connector list
コネクタを検索します。
pa connector list --search teams
コネクタリストを JSON として返します。
pa connector list --json
pa solution list
フレンドリ名、一意の名前、ソリューション ID など、現在の環境のソリューションを一覧表示します。
pa solution list [--search <term>] [--json]
pa solution list パラメーター
| パラメーター | Description |
|---|---|
--search |
ソリューションをフレンドリ名または一意の名前でフィルター処理します。 フィルターは、大文字と小文字を区別しない部分文字列の一致です。 |
--json |
完全なソリューション一覧を JSON として返します。 |
PA_CLI_SOLUTION_SEARCH は、 --search パラメーターの対応する環境変数です。
対話型ターミナルでは、結果が 20 行のページで表示されます。
Enter キーを押して次のページを表示します。
Esc キーまたは Q キーを押して終了します。 出力をリダイレクトするか、 --jsonを含めると、コマンドは完全なリストを返します。
pa telemetry disable
テレメトリ収集を無効にします。
pa telemetry disable
pa telemetry enable
テレメトリ収集を有効にします。
pa telemetry enable
pa telemetry status
現在のテレメトリ設定を表示します。
pa telemetry status