zmienne środowiskowe interfejsu wiersza polecenia Power Apps

Użyj zmiennych środowiskowych, aby skonfigurować uwierzytelnianie interfejsu wiersza polecenia Power Apps i udostępnić opcje poleceń w skryptach i potokach ciągłej integracji/ciągłego wdrażania. Zmienne środowiskowe zdefiniowane przez interfejs wiersza polecenia Power Apps używają prefiksuPA_CLI_.

Note

Zmienne środowiskowe są nazwanymi wartościami udostępnianymi przez system operacyjny aplikacjom. Power Apps interfejs wiersza polecenia rozpoznaje zmienne opisane w tym dokumentacji. Aby dowiedzieć się, jak działają zmienne środowiskowe i jak nimi zarządzać, zobacz informacje o zmiennych środowiskowych.

W tej dokumentacji opisano zmienne środowiskowe systemu operacyjnego, które konfigurują interfejs wiersza polecenia Power Apps. Te zmienne różnią się od zmiennych środowiskowych rozwiązania Power Platform, które przechowują wartości konfiguracji używane przez aplikację.

W przypadku opcji polecenia interfejs wiersza polecenia rozpoznaje wartość w następującej kolejności:

Opcja wiersza polecenia
Zmienna środowiskowa
Wartość domyślna, jeśli opcja ma jedną wartość
Monit interakcyjny, jeśli jest obsługiwany

Opcja podana w wierszu polecenia ma pierwszeństwo przed odpowiednią zmienną środowiskową.

Important

Zmienne środowiskowe mogą uwidaczniać wpisy tajne w innych procesach, dziennikach lub historii powłoki. Zapisz PA_CLI_SP_CLIENT_SECRET go w magazynie wpisów tajnych platformy ciągłej integracji/ciągłego wdrażania, zamaskuj go z dzienników i nie zatwierdzaj wpisów tajnych do kontroli źródła.

Ustawianie zmiennych środowiskowych

Poniższe przykłady ustawione PA_CLI_ENVIRONMENT_ID przed uruchomieniem polecenia interfejsu wiersza polecenia Power Apps.

PowerShell
Bash

$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list

export PA_CLI_ENVIRONMENT_ID="<environment-id>"
pa app list

Zmienna środowiskowa pozostaje dostępna dla poleceń uruchomionych z tej samej sesji terminalu. Użyj standardowego polecenia powłoki, aby usunąć go, gdy nie jest już potrzebny.

Uwierzytelnianie

Zmienna środowiskowa	Description
`PA_CLI_ACCOUNT`	Określa konto dla `pa auth login` lub `pa auth switch`.
`PA_CLI_SP_CLIENT_ID`	Określa identyfikator aplikacji Microsoft Entra (klienta) na potrzeby uwierzytelniania jednostki usługi.
`PA_CLI_SP_CLIENT_SECRET`	Określa klucz tajny klienta na potrzeby uwierzytelniania jednostki usługi.
`PA_CLI_SP_TENANT_ID`	Określa identyfikator katalogu Microsoft Entra (dzierżawy) na potrzeby uwierzytelniania jednostki usługi.
`PA_CLI_USE_SP_AUTH`	Ustaw wartość na `true` (małe litery), aby używać uwierzytelniania jednostki usługi.

Trzy PA_CLI_SP_* zmienne poświadczeń są wymagane, gdy wybrano uwierzytelnianie jednostki usługi. Mimo że CI=true wybiera również uwierzytelnianie jednostki usługi w celu zachowania zgodności, użyj polecenia PA_CLI_USE_SP_AUTH=true , aby jawnie ustawić tryb uwierzytelniania.

Aby uzyskać instrukcje dotyczące konfiguracji, zobacz Publikowanie aplikacji kodu Power Apps przy użyciu jednostki usługi.

Opcje poleceń globalnych

Te zmienne odpowiadają opcjom dostępnym w poleceniach interfejsu wiersza polecenia Power Apps.

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_CLOUD`	`--cloud`	Wybiera chmurę docelową. Prawidłowe wartości to: - `public` (ustawienie domyślne) - `usgov` - `usgovhigh` - `usgovdod` - `china` Wartości są niewrażliwe na wielkość liter.
`PA_CLI_ENVIRONMENT_ID`	`--environment-id`	Określa docelowy identyfikator środowiska platformy Power Platform.

Inicjowanie aplikacji

Te zmienne udostępniają opcje .pa app init

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_APP_BUILD_PATH`	`--build-path`	Określa katalog wyjściowy kompilacji. Wartość domyślna to `./dist`.
`PA_CLI_APP_DESCRIPTION`	`--description`	Określa opis aplikacji.
`PA_CLI_APP_DISPLAY_NAME`	`--display-name`	Określa nazwę wyświetlaną aplikacji.
`PA_CLI_APP_FILE_ENTRY_POINT`	`--file-entry-point`	Określa punkt wejścia HTML w danych wyjściowych kompilacji. Wartość domyślna to `index.html`.
`PA_CLI_APP_TYPE`	`--app-type`	Określa typ aplikacji. Prawidłowe wartości to: - `CodeApp` (ustawienie domyślne) - `MobileApp` Wartość jest zapisywana i `power.config.json` używana jako typ aplikacji po opublikowaniu aplikacji.
`PA_CLI_APP_URL`	`--app-url`	Określa lokalny adres URL aplikacji podczas .`pa app init` Wartość jest zapisywana w formacie `localAppUrl` in `power.config.json` i staje się domyślnym adresem URL dla przyszłych `pa app run` poleceń. Wartość domyślna to `http://localhost:3000`.

Uruchamianie aplikacji

Te zmienne udostępniają opcje .pa app run

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_LOCAL_APP_URL`	`--local-app-url`	`localAppUrl` Zastępuje wartość z `power.config.json` dla bieżącego polecenia bez zmiany zapisanej konfiguracji. Jeśli żadna wartość nie jest ustawiona, wartość domyślna to `http://localhost:3000`.
`PA_CLI_PORT`	`--port`	Określa port Power Apps hosta lokalnego. Wartość domyślna to `8080`.

Te zmienne udostępniają opcje .pa app share

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_SHARE_ACCESS`	`--access`	Określa poziom dostępu. Prawidłowe wartości to: - `play` (ustawienie domyślne) - `edit`
`PA_CLI_SHARE_PRINCIPAL`	`--principal`	Określa co najmniej jeden adres e-mail rozdzielony przecinkami lub identyfikatory obiektów Microsoft Entra.

Rozwiązania, łączniki i źródła danych

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_CONNECTION_DISPLAY_NAME`	`--display-name`	Określa nazwę wyświetlaną podczas tworzenia połączenia.
`PA_CLI_CONNECTION_ID`	`--connection-id`	Określa identyfikator wystąpienia połączenia łącznika.
`PA_CLI_CONNECTION_REF`	`--connection-ref`	Określa nazwę logiczną odwołania do połączenia.
`PA_CLI_CONNECTION_SEARCH`	`--search`	Filtruje wyniki z `pa connection list`.
`PA_CLI_CONNECTOR`	`--connector`	Określa identyfikator łącznika, taki jak `shared_office365users`.
`PA_CLI_CONNECTOR_SEARCH`	`--search`	Filtruje wyniki z `pa connector list`.
`PA_CLI_DATASET`	`--dataset`	Określa zestaw danych, taki jak lokacja SharePoint lub baza danych SQL.
`PA_CLI_DATA_SOURCE_NAME`	`--name`	Określa źródło danych do odświeżenia lub usunięcia.
`PA_CLI_ORG_URL`	`--org-url`	Zastępuje adres URL organizacji usługi Dataverse używany do pobierania metadanych podczas dodawania źródła danych.
`PA_CLI_PROCEDURE`	`--procedure`	Określa procedurę składowaną SQL.
`PA_CLI_SOLUTION_ID`	`--solution-id`	Określa rozwiązanie dla `pa app push`, `pa app add data-source`lub `pa connection list-references`.
`PA_CLI_SOLUTION_SEARCH`	`--search`	Filtruje wyniki z `pa solution list`.
`PA_CLI_TABLE`	`--table`	Określa nazwę zasobu tabeli lub łącznika.

Aby zapoznać się z poleceniami, które akceptują każdą opcję, zobacz dokumentację poleceń interfejsu wiersza polecenia Power Apps.

Interfejsy API usługi Dataverse i przepływy Power Automate

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_DATAVERSE_API_NAME`	`--api-name`	Określa akcję lub funkcję Dataverse, która ma zostać dodana za pomocą aplikacji pa, dodaj element dataverse-api.
`PA_CLI_DATAVERSE_API_SEARCH_TERM`	`--search`	Filtruje akcje i funkcje Dataverse według nazwy za pomocą `pa app find-dataverse-api`polecenia .
`PA_CLI_FLOW_DATA_SOURCE_NAME`	`--flow-name`	Określa źródło danych przepływu do usunięcia z aplikacji za pomocą polecenia `pa app remove flow`
`PA_CLI_FLOW_ID`	`--flow-id`	Określa przepływ Power Automate do dodania za pomocą `pa app add flow`polecenia .
`PA_CLI_FLOW_SEARCH`	`--search`	Filtruje dostępne przepływy Power Automate według nazwy`pa app list-flows`
`PA_CLI_REMOVE_FLOW_ID`	`--flow-id`	Określa przepływ Power Automate do usunięcia za pomocą polecenia`pa app remove flow`

Dane telemetryczne i dane wyjściowe konsoli

Zmienna środowiskowa	Odpowiednia opcja	Description
`PA_CLI_CONSOLE_ONLY`	`--console-only`	Ustaw wartość `true` na (małe litery) z `pa telemetry enable` lub `pa telemetry disable` zapisać dane telemetryczne tylko do konsoli i nie wysyłać jej zdalnie.
`PA_CLI_OUTPUT_TO_CONSOLE`	`--output-to-console`	Ustaw wartość na `true` (małe litery) z `pa telemetry enable` lub `pa telemetry disable` do zdublowania zdalnie wysyłanych zdarzeń telemetrycznych do konsoli.
`PA_CLI_TELEMETRY`	Żadne	Ustaw jedną z tych wartości, aby wyłączyć dane telemetryczne dla bieżącego procesu: - `0` - `false` - `no` - `off` Wartości są bez uwzględniania wielkości liter, a otaczające przestrzenie są ignorowane.

Aby uzyskać informacje o trwałych ustawieniach telemetrii, zobacz Zarządzanie ustawieniami telemetrii dla interfejsu wiersza polecenia Power Apps.

Standardowe zmienne środowiskowe

Interfejs wiersza polecenia obserwuje również tę standardową zmienną środowiskową:

Zmienna środowiskowa	Description
`NO_COLOR`	Ustaw tę zmienną na wartość nonempty, aby wyłączyć dane wyjściowe koloru ANSI. Możesz również użyć `--no-color` opcji .

Opinia

Czy ta strona była pomocna?

Last updated on 2026-09-01