環境変数を使用して、Power Apps CLI 認証を構成し、スクリプトと CI/CD パイプラインでコマンド オプションを指定します。 Power Apps CLI によって定義された環境変数では、PA_CLI_ プレフィックスが使用されます。
Note
環境変数は、オペレーティング システムがアプリケーションで使用できるようにする名前付き値です。 Power Apps CLI は、このリファレンスで説明されている変数を認識します。 環境変数のしくみとその管理方法については、「 環境変数」を参照してください。
このリファレンスでは、Power Apps CLI を構成するオペレーティング システム環境変数について説明します。 これらの変数は、アプリで使用される構成値を格納する Power Platform ソリューション環境変数とは異なります。
コマンド オプションの場合、CLI は次の順序で値を解決します。
- コマンド ライン オプション
- 環境変数
- オプションに既定値がある場合
- 対話型プロンプト (サポートされている場合)
コマンド ラインで指定されたオプションは、対応する環境変数よりも優先されます。
Important
環境変数は、他のプロセス、ログ、またはシェル履歴にシークレットを公開できます。 CI/CD プラットフォームのシークレット ストアに PA_CLI_SP_CLIENT_SECRET を格納し、ログからマスクし、シークレットをソース管理にコミットしません。
環境変数の設定
次の例では、Power Apps CLI コマンドを実行する前にPA_CLI_ENVIRONMENT_ID設定します。
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
環境変数は、同じターミナル セッションから開始されたコマンドで引き続き使用できます。 シェルの標準コマンドを使用して、不要になったら削除します。
認証
| 環境変数 | Description |
|---|---|
PA_CLI_ACCOUNT |
pa auth loginまたはpa auth switchのアカウントを指定します。 |
PA_CLI_SP_CLIENT_ID |
サービス プリンシパル認証のMicrosoft Entra アプリケーション (クライアント) ID を指定します。 |
PA_CLI_SP_CLIENT_SECRET |
サービス プリンシパル認証のクライアント シークレットを指定します。 |
PA_CLI_SP_TENANT_ID |
サービス プリンシパル認証のMicrosoft Entra ディレクトリ (テナント) ID を指定します。 |
PA_CLI_USE_SP_AUTH |
サービス プリンシパル認証を使用するには、値を true (小文字) に設定します。 |
サービス プリンシパル認証が選択されている場合は、3 つの PA_CLI_SP_* 資格情報変数が必要です。
CI=trueは互換性のためにサービス プリンシパル認証も選択しますが、PA_CLI_USE_SP_AUTH=trueを使用して認証モードを明示的にします。
セットアップ手順については、「サービス プリンシパルを使用してコード アプリPower Apps発行する」を参照してください。
グローバル コマンド オプション
これらの変数は、Power Apps CLI コマンドで使用できるオプションに対応します。
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
ターゲット クラウドを選択します。 有効な値は次のとおりです。 - public (既定)- usgov- usgovhigh- usgovdod- china値では大文字と小文字が区別されません。 |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
ターゲットの Power Platform 環境 ID を指定します。 |
アプリの初期化
これらの変数は、 pa app initするオプションを提供します。
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
ビルド出力ディレクトリを指定します。 既定値は ./dist です。 |
PA_CLI_APP_DESCRIPTION |
--description |
アプリの説明を指定します。 |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
アプリの表示名を指定します。 |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
ビルド出力の HTML エントリ ポイントを指定します。 既定値は index.html です。 |
PA_CLI_APP_TYPE |
--app-type |
アプリの種類を指定します。 有効な値は次のとおりです。 - CodeApp (既定)- MobileApp値は power.config.json に保存され、アプリの発行時にアプリの種類として使用されます。 |
PA_CLI_APP_URL |
--app-url |
pa app init中のローカル アプリの URL を指定します。 値はpower.config.jsonにlocalAppUrlとして保存され、今後のpa app runコマンドの既定の URL になります。 既定値は http://localhost:3000 です。 |
アプリを実行する
これらの変数は、 pa app runするオプションを提供します。
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
保存された構成を変更せずに、現在のコマンドのpower.config.jsonからlocalAppUrl値をオーバーライドします。 どちらの値も設定されていない場合、既定値は http://localhost:3000。 |
PA_CLI_PORT |
--port |
Power Apps ローカル ホストのポートを指定します。 既定値は 8080 です。 |
アプリの共有
これらの変数は、 pa app shareするオプションを提供します。
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
アクセス レベルを指定します。 有効な値は次のとおりです。 - play (既定)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
1 つ以上のコンマ区切りの電子メール アドレスまたはMicrosoft Entraオブジェクト ID を指定します。 |
ソリューション、コネクタ、データ ソース
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
接続を作成するときの表示名を指定します。 |
PA_CLI_CONNECTION_ID |
--connection-id |
コネクタ接続インスタンス ID を指定します。 |
PA_CLI_CONNECTION_REF |
--connection-ref |
接続参照の論理名を指定します。 |
PA_CLI_CONNECTION_SEARCH |
--search |
pa connection listからの結果をフィルター処理します。 |
PA_CLI_CONNECTOR |
--connector |
shared_office365usersなどのコネクタ ID を指定します。 |
PA_CLI_CONNECTOR_SEARCH |
--search |
pa connector listからの結果をフィルター処理します。 |
PA_CLI_DATASET |
--dataset |
SharePoint サイトや SQL データベースなどのデータセットを指定します。 |
PA_CLI_DATA_SOURCE_NAME |
--name |
更新または削除するデータ ソースを指定します。 |
PA_CLI_ORG_URL |
--org-url |
データ ソースを追加するときにメタデータを取得するために使用される Dataverse 組織の URL をオーバーライドします。 |
PA_CLI_PROCEDURE |
--procedure |
SQL ストアド プロシージャを指定します。 |
PA_CLI_SOLUTION_ID |
--solution-id |
pa app push、pa app add data-source、またはpa connection list-referencesのソリューションを指定します。 |
PA_CLI_SOLUTION_SEARCH |
--search |
pa solution listからの結果をフィルター処理します。 |
PA_CLI_TABLE |
--table |
テーブルまたはコネクタのリソース名を指定します。 |
各オプションを受け入れるコマンドについては、Power Apps CLI コマンド リファレンスを参照してください。
Dataverse API とPower Automate フロー
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
pa app add dataverse-api を使用して追加する Dataverse アクションまたは関数を指定します。 |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
pa app find-dataverse-apiを使用して、名前で Dataverse のアクションと関数をフィルター処理します。 |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
アプリから削除するフロー データ ソースを指定します。 pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
pa app add flowで追加するPower Automate フローを指定します。 |
PA_CLI_FLOW_SEARCH |
--search |
使用可能なPower Automate フローを名前でフィルター処理します。pa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
削除するPower Automate フローを指定します。pa app remove flow |
テレメトリとコンソールの出力
| 環境変数 | 対応するオプション | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
pa telemetry enableを使用して値をtrue (小文字) に設定するか、テレメトリをコンソールにのみ書き込み、リモートで送信しないようにpa telemetry disableします。 |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
リモートから送信されたテレメトリ イベントをコンソールにミラーリングするには、pa telemetry enableまたはpa telemetry disableを使用して値を true (小文字) に設定します。 |
PA_CLI_TELEMETRY |
None | 現在のプロセスのテレメトリを無効にするには、次のいずれかの値を設定します。 - 0- false- no- off値では大文字と小文字が区別されず、周囲のスペースは無視されます。 |
永続的なテレメトリ設定については、Power Apps CLI のテレメトリ設定の管理に関するページを参照してください。
標準環境変数
CLI では、次の標準環境変数も確認されます。
| 環境変数 | Description |
|---|---|
NO_COLOR |
ANSI カラー出力を無効にするには、この変数を空でない値に設定します。
--no-color オプションを使用することもできます。 |