POWER APPS CLI コマンド リファレンス

この 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 の場合:

  1. --connectorを指定しない場合、コマンドはコネクタ ID を要求します。
  2. このコマンドは、テーブルの論理名を要求します。
  3. 指定されていない場合、コマンドは Dataverse 組織の URL を要求します。

Native Dataverse では、接続 ID、接続参照、またはデータセットは使用されません。

コネクタに基づくデータ ソースの場合:

コネクタとデータ ソースの種類を選択する

  1. --connectorを指定しない場合、コマンドはコネクタ ID を要求します。
  2. コネクタがテーブルとアクションの両方をサポートしていて、何も追加する内容が決まっていない場合、コマンドはテーブルの追加を求めます。

接続を選択する

このコマンドは、 接続 ID の代わりに接続参照を使用していますか? 接続 ID または接続参照を指定する場合、この質問はスキップされます。

  • [はい] を選択すると、コマンドによって接続参照の論理名が求められます。
  • [いいえ] を選択すると、コネクタの接続が一覧表示されます。 ( 手動で入力...) を選択して、一覧にない接続 ID を入力します。

データを選択する

  • アクションを追加する場合、このコマンドはストアド プロシージャ、データセット、およびテーブル プロンプトをスキップします。

  • テーブルまたはストアド プロシージャを追加する場合:

    1. SQL Serverの場合、このコマンドはストアド プロシージャを追加するかどうかを確認します。 ある場合は、ストアド プロシージャ名を要求します。
    2. このコマンドは、接続を介して使用可能なデータセットを一覧表示します。 (手動で入力...) を選択して、一覧にないデータセットを入力します。
    3. ストアド プロシージャを追加する場合を除き、このコマンドを実行すると、データセット内のテーブルの検索可能な一覧が開きます。 複数のテーブルを選択できます。

接続参照を使用する場合、データセットとテーブルの一覧は、参照が指す接続から取得されます。

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を実行するユーザーは、フローとその基になる接続にアクセスできる必要があります。 ユーザーが必要な接続にアクセスできない場合、コマンドは失敗します。

このコマンドを使用するシナリオの詳細については、以下を参照してください。

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 クラウド インスタンス。

これらのパラメーターには、対応する アプリ初期化 環境変数があります。

このコマンドを使用できるシナリオの詳細については、以下を参照してください。

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