Power Apps proměnných prostředí rozhraní příkazového řádku

Pomocí proměnných prostředí můžete nakonfigurovat ověřování rozhraní příkazového řádku Power Apps a poskytovat možnosti příkazů ve skriptech a kanálech CI/CD. Proměnné prostředí definované rozhraním příkazového řádku Power Apps používají předponuPA_CLI_.

Note

Proměnné prostředí jsou pojmenované hodnoty, které operační systém zpřístupňuje aplikacím. Power Apps rozhraní příkazového řádku rozpozná proměnné popsané v tomto odkazu. Informace o tom, jak proměnné prostředí fungují a jak je spravovat, najdete v tématu o proměnných prostředí.

Tento odkaz popisuje proměnné prostředí operačního systému, které konfigurují Power Apps rozhraní příkazového řádku. Tyto proměnné se liší od proměnných prostředí řešení Power Platform, které ukládají hodnoty konfigurace používané aplikací.

U možnosti příkazu rozhraní příkazového řádku přeloží hodnotu v tomto pořadí:

  1. Možnost příkazového řádku
  2. Proměnná prostředí
  3. Výchozí hodnota, pokud má tato možnost jednu
  4. Interaktivní výzva, pokud je podporována

Možnost zadaná na příkazovém řádku má přednost před odpovídající proměnnou prostředí.

Important

Proměnné prostředí můžou zpřístupnit tajné kódy jiným procesům, protokolům nebo historii prostředí. Uložte PA_CLI_SP_CLIENT_SECRET je do úložiště tajných kódů platformy CI/CD, zamaskujte ho z protokolů a nepokládejte tajné kódy do správy zdrojového kódu.

Nastavení proměnných prostředí

Následující příklady jsou nastavené PA_CLI_ENVIRONMENT_ID před spuštěním příkazu rozhraní příkazového řádku Power Apps.

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

Proměnná prostředí zůstává k dispozici pro příkazy spuštěné ze stejné relace terminálu. Standardním příkazem prostředí ho odeberte, když už ho nepotřebujete.

Autentizace

Proměnná prostředí Description
PA_CLI_ACCOUNT Určuje účet pro pa auth login nebo pa auth switch.
PA_CLI_SP_CLIENT_ID Určuje ID Microsoft Entra aplikace (klienta) pro ověřování instančního objektu.
PA_CLI_SP_CLIENT_SECRET Určuje tajný klíč klienta pro ověřování instančního objektu.
PA_CLI_SP_TENANT_ID Určuje ID adresáře Microsoft Entra (tenanta) pro ověřování instančního objektu.
PA_CLI_USE_SP_AUTH Nastavte hodnotu na true (malá písmena) pro použití ověřování instančního objektu.

Při výběru ověřování instančního objektu se vyžadují tři PA_CLI_SP_* proměnné přihlašovacích údajů. I když CI=true pro kompatibilitu vybere také ověřování instančního objektu, použije PA_CLI_USE_SP_AUTH=true se k explicitnímu nastavení režimu ověřování.

Pokyny k nastavení najdete v tématu Publikování Power Apps aplikací kódu pomocí instančního objektu.

Globální možnosti příkazů

Tyto proměnné odpovídají možnostem dostupným napříč příkazy rozhraní příkazového řádku Power Apps.

Proměnná prostředí Odpovídající možnost Description
PA_CLI_CLOUD --cloud Vybere cílový cloud. Platné hodnoty jsou:
- public (výchozí)
- usgov
- usgovhigh
- usgovdod
- china
Hodnoty nerozlišují malá a velká písmena.
PA_CLI_ENVIRONMENT_ID --environment-id Určuje ID cílového prostředí Power Platform.

Inicializace aplikace

Tyto proměnné poskytují možnosti pa app init.

Proměnná prostředí Odpovídající možnost Description
PA_CLI_APP_BUILD_PATH --build-path Určuje výstupní adresář sestavení. Výchozí hodnota je ./dist.
PA_CLI_APP_DESCRIPTION --description Určuje popis aplikace.
PA_CLI_APP_DISPLAY_NAME --display-name Určuje zobrazovaný název aplikace.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Určuje vstupní bod HTML ve výstupu sestavení. Výchozí hodnota je index.html.
PA_CLI_APP_TYPE --app-type Určuje typ aplikace. Platné hodnoty jsou:
- CodeApp (výchozí)
- MobileApp
Hodnota se uloží a power.config.json použije se jako typ aplikace při publikování aplikace.
PA_CLI_APP_URL --app-url Určuje adresu URL místní aplikace během pa app init. Hodnota se uloží jako localAppUrl in power.config.json a stane se výchozí adresou URL pro budoucí pa app run příkazy. Výchozí hodnota je http://localhost:3000.

Spouštění aplikací

Tyto proměnné poskytují možnosti pa app run.

Proměnná prostředí Odpovídající možnost Description
PA_CLI_LOCAL_APP_URL --local-app-url localAppUrl Přepíše hodnotu aktuálního power.config.json příkazu beze změny uložené konfigurace. Pokud není nastavena žádná hodnota, výchozí hodnota je http://localhost:3000.
PA_CLI_PORT --port Určuje port pro Power Apps místního hostitele. Výchozí hodnota je 8080.

Sdílení aplikací

Tyto proměnné poskytují možnosti pa app share.

Proměnná prostředí Odpovídající možnost Description
PA_CLI_SHARE_ACCESS --access Určuje úroveň přístupu. Platné hodnoty jsou:
- play (výchozí)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Určuje jednu nebo více e-mailových adres oddělených čárkami nebo ID objektů Microsoft Entra.

Řešení, konektory a zdroje dat

Proměnná prostředí Odpovídající možnost Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Určuje zobrazovaný název při vytváření připojení.
PA_CLI_CONNECTION_ID --connection-id Určuje ID instance připojení konektoru.
PA_CLI_CONNECTION_REF --connection-ref Určuje logický název odkazu na připojení.
PA_CLI_CONNECTION_SEARCH --search Filtruje výsledky z pa connection list.
PA_CLI_CONNECTOR --connector Určuje ID konektoru, například shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtruje výsledky z pa connector list.
PA_CLI_DATASET --dataset Určuje datovou sadu, například SharePoint lokalitu nebo databázi SQL.
PA_CLI_DATA_SOURCE_NAME --name Určuje zdroj dat, který se má aktualizovat nebo odebrat.
PA_CLI_ORG_URL --org-url Přepíše adresu URL organizace Dataverse použitou k načtení metadat při přidávání zdroje dat.
PA_CLI_PROCEDURE --procedure Určuje uloženou proceduru SQL.
PA_CLI_SOLUTION_ID --solution-id Určuje řešení pro pa app push, pa app add data-sourcenebo pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtruje výsledky z pa solution list.
PA_CLI_TABLE --table Určuje název prostředku tabulky nebo konektoru.

Příkazy, které přijímají jednotlivé možnosti, najdete v referenčních informacích k příkazům rozhraní příkazového řádku Power Apps.

Rozhraní API služby Dataverse a toky Power Automate

Proměnná prostředí Odpovídající možnost Description
PA_CLI_DATAVERSE_API_NAME --api-name Určuje akci Nebo funkci Dataverse, která se má přidat pomocí aplikace Pa, přidat dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtruje akce a funkce Dataverse podle názvu pomocí pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Určuje zdroj dat toku, který se má z aplikace odebrat. pa app remove flow
PA_CLI_FLOW_ID --flow-id Určuje tok Power Automate, který se má přidat pomocí pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtruje dostupné Power Automate toky podle názvu.pa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Určuje tok Power Automate, který se má odebrat.pa app remove flow

Telemetrie a výstup konzoly

Proměnná prostředí Odpovídající možnost Description
PA_CLI_CONSOLE_ONLY --console-only Nastavte hodnotu na true (malá písmena) s pa telemetry enable telemetrií nebo pa telemetry disable ji zapisujte pouze do konzoly a neodesílejte ji vzdáleně.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Nastavte hodnotu na true (malá písmena) s událostmi pa telemetry enable vzdáleného odeslání telemetrie do konzoly nebo pa telemetry disable je zrcadlit.
PA_CLI_TELEMETRY None Nastavte jednu z těchto hodnot tak, aby se zakázala telemetrie pro aktuální proces:
- 0
- false
- no
- off
Hodnoty nerozlišují malá a velká písmena a okolní mezery se ignorují.

Informace o trvalých nastaveních telemetrie najdete v tématu Správa nastavení telemetrie pro rozhraní příkazového řádku Power Apps.

Standardní proměnné prostředí

Rozhraní příkazového řádku také sleduje tuto standardní proměnnou prostředí:

Proměnná prostředí Description
NO_COLOR Nastavte tuto proměnnou na neprázdnou hodnotu, aby se zakázal výstup barvy ANSI. Můžete také použít --no-color tuto možnost.
  • Last updated on