Referenční informace k příkazům rozhraní příkazového řádku Power Apps

Pomocí tohoto Power Apps reference k příkazům rozhraní příkazového řádku můžete rychle najít příkazy pro vytváření, vývoj, připojení a publikování Power Apps aplikací kódu. Rozhraní příkazového řádku používá seskupené příkazy v následujícím formátu:

pa <command-group> <command>

Toto jsou skupiny příkazů:

Skupina příkazů Description
pa app Vytvářejte, spouštějte, připojujte a publikujte aplikace kódu.
pa auth Přihlaste se a spravujte účty.
pa connection Vytváření a správa připojení a zjišťování jejich prostředků
pa connector Vyhledejte konektory dostupné v prostředí Power Platform.
pa solution Vyhledejte řešení dostupná v prostředí Power Platform.
pa telemetry Správa nastavení telemetrie rozhraní příkazového řádku

Globální možnosti

Nápovědu --help v terminálu můžete zobrazit na libovolné úrovni:

pa --help
pa app --help
pa app init --help

Slouží --version k zobrazení nainstalované verze rozhraní příkazového řádku Power Apps:

pa --version

příkazy rozhraní příkazového řádku Power Apps

K dispozici jsou tyto příkazy:

Command Description
pa app add data-source Přidejte do aplikace kódu konektor nebo tabulkový zdroj dat.
pa app add dataverse-api Přidejte do aplikace kódu akci Nebo funkci Dataverse.
pa app add flow Přidejte do aplikace kódu tok Power Automate.
pa app find-dataverse-api Vyhledejte akce a funkce Dataverse v aktuálním prostředí.
pa app get-settings Zobrazí aktuální nastavení aplikace.
pa app init Inicializace aplikace kódu v aktuálním adresáři
pa app list Vypisujte aplikace kódu v aktuálním prostředí.
pa app list-environment-variables Vytvořte seznam proměnných prostředí dostupných pro aplikaci kódu.
pa app list-flows Zobrazení seznamu Power Automate toků s podporou řešení v aktuálním prostředí
pa app push Publikujte novou verzi aplikace kódu do Power Apps.
pa app refresh data-source Aktualizujte vygenerované soubory pro zdroj dat.
pa app remove data-source Odeberte zdroj dat z aplikace kódu.
pa app remove flow Odeberte Power Automate tok z aplikace kódu.
pa app run Spusťte Power Apps místního hostitele aplikace kódu.
pa app set-setting Aktualizujte nastavení aplikace.
pa app share Sdílejte aplikaci kódu s uživateli nebo instančními objekty.
pa auth login Přihlaste se v systémovém prohlížeči.
pa auth logout Odhlaste se a odeberte uložené ověřovací informace.
pa auth status Zobrazte přihlášené účty a identifikujte aktivní účet.
pa auth switch Změňte aktivní účet.
pa connection create Vytvořte připojení pro konektor.
pa connection list Zobrazení seznamu připojení v aktuálním prostředí
pa connection list-datasets Výpis datových sad dostupných prostřednictvím připojení
pa connection list-procedures Výpis uložených procedur SQL dostupných v datové sadě
pa connection list-references Výpis odkazů na připojení v řešení
pa connection list-tables Výpis tabulek dostupných v datové sadě
pa connector list Výpis konektorů dostupných v aktuálním prostředí Power Platform
pa solution list Vypisujte řešení v aktuálním prostředí.
pa telemetry disable Zakažte shromažďování telemetrie.
pa telemetry enable Povolte shromažďování telemetrických dat.
pa telemetry status Zobrazí aktuální nastavení telemetrie.

pa app add data-source

Přidá do aplikace kódu konektor nebo tabulkový zdroj dat.

pa app add data-source --connector <connector-id> [options]

pa app add data-source parametry

Parameter Description
--connector Identifikátor konektoru, například nebo zobrazovaný název konektoru, například shared_office365users"Uživatelé Office 365". Pokud zobrazovaný název odpovídá více než jednomu konektoru, zobrazí příkaz seznam odpovídajících identifikátorů konektoru, abyste ho mohli zadat.
--as Určuje, jestli chcete konektor přidat jako table zdroj dat nebo action jako zdroj dat. Tento parametr použijte u konektorů, které podporují tabulky i akce, jako jsou SharePoint a SQL Server. Další informace najdete v pa app add data-source poznámkách.
--connection-id ID připojení, které se má použít pro zdroj dat.
--connection-ref Logický název odkazu na připojení, například cr123_sharedsharepointonline_1a2b3.
--solution-id Řešení, které obsahuje odkaz na připojení.
--dataset Datová sada pro tabulkový zdroj dat.
--table Tabulka, která se má přidat. Tento parametr opakujte, pokud chcete přidat více tabulek ze stejného konektoru, připojení a datové sady. Nativní dataverse podporuje jednu tabulku na příkaz.
--org-url Adresa URL organizace Dataverse používaná k načtení nativních metadat tabulky Dataverse. Pokud ji v interaktivním režimu nezadáte jako možnost příkazu nebo proměnnou prostředí, příkazový řádek pro tuto hodnotu.
--procedure Uložená procedura SQL, která se má přidat.

Tyto parametry mají odpovídající proměnné prostředí řešení, konektorů a zdrojů dat .

pa app add data-source Poznámky

Pokud chcete přidat více tabulek spojnic v jednom příkazu, opakujte --table pro každou tabulku. Tabulky musí používat stejný konektor, připojení a datovou sadu. Příkaz přidá duplicitní identifikátory tabulky pouze jednou. Pro každý příkaz můžete zahrnout pouze jednu nativní tabulku Dataverse nebo uloženou proceduru SQL.

Pokud selže operace zápisu do konkrétní tabulky, ověření nebo zápisu schématu, příkaz stále přidá platné tabulky. Hlásí seřazené succeeded a failed výsledky a vrátí nenulový ukončovací kód, pokud nějaká tabulka selže. Před opakováním zkontrolujte výsledky.

Některé konektory, například SharePoint a SQL Server, podporují tabulky i akce. U těchto konektorů zadejte, co chcete přidat:

  • Pokud chcete přidat tabulky nebo uloženou proceduru SQL, použijte nebo zahrňte --as table--table nebo --procedure.
  • Pokud chcete přidat akce konektoru, použijte --as action. Nemůžete použít --as action s --dataset, --tablenebo --procedure.

Pokud nezadáte, co přidat, příkaz požádá o přidání tabulky? v interaktivním terminálu. V neinteraktivním režimu příkaz selže, dokud nezadáte --as. Konektory, které podporují jenom akce, jako je Uživatelé Office 365, nepotřebují --as a nepodporují --as table. Pokud chcete přidat akce nebo funkce Dataverse, použijte místo pa app add dataverse-api--as action.

V interaktivním terminálu příkazový řádek zobrazí požadované hodnoty, které nezadáte jako možnosti příkazů nebo proměnné prostředí. Výzvy závisí na typu zdroje dat.

Pro nativní službu Dataverse:

  1. Pokud ho nezadáte --connector, příkaz požádá o ID konektoru.
  2. Příkaz požádá o logický název tabulky.
  3. Příkaz požádá o adresu URL organizace Dataverse, pokud není k dispozici.

Native Dataverse nepoužívá ID připojení, odkaz na připojení ani datovou sadu.

Pro zdroje dat založené na konektorech:

Volba konektoru a typu zdroje dat

  1. Pokud ho nezadáte --connector, příkaz požádá o ID konektoru.
  2. Pokud konektor podporuje tabulky i akce a nic jiného, co se má přidat, příkaz požádá o přidání tabulky?

Volba připojení

Příkaz se zeptá, jestli používáte odkaz na připojení místo ID připojení? Tuto otázku přeskočí, když zadáte ID připojení nebo odkaz na připojení.

  • Pokud vyberete Ano, příkaz požádá o logický název odkazu na připojení.
  • Pokud vyberete Ne, zobrazí příkaz seznam připojení pro konektor. Vyberte (Enter ručně...) a zadejte ID připojení, které není v seznamu.

Zvolte data.

  • Pokud přidáváte akce, příkaz přeskočí uloženou proceduru, datovou sadu a výzvy tabulky.

  • Pokud přidáváte tabulky nebo uloženou proceduru:

    1. U SQL Server se příkaz zeptá, jestli přidáváte uloženou proceduru. Pokud jste, požádá o název uložené procedury.
    2. Příkaz zobrazí seznam datových sad dostupných prostřednictvím připojení. Vyberte (Enter ručně...) a zadejte datovou sadu, která není v seznamu.
    3. Pokud nepřidáte uloženou proceduru, příkaz otevře prohledávatelný seznam tabulek v datové sadě. Můžete vybrat více než jednu tabulku.

Když použijete odkaz na připojení, seznam datových sad a tabulek pochází z připojení, na které odkazuje odkaz.

příklady pa app add data-source

Přidejte zdroj dat zodpovězením výzev:

pa app add data-source

Přidejte nativní tabulku Dataverse:

pa app add data-source --connector dataverse --table account

Přidejte akce konektoru, který podporuje také tabulky:

pa app add data-source \
  --connector shared_sharepointonline \
  --connection-id <connection-id> \
  --as action

Přidejte SharePoint list pomocí zobrazovaného názvu konektoru:

pa app add data-source \
  --connector "SharePoint" \
  --connection-id <connection-id> \
  --dataset <site-url> \
  --table <list-name>

Přidejte několik tabulek SQL ze stejné datové sady:

pa app add data-source \
  --connector shared_sql \
  --connection-id <connection-id> \
  --dataset <server-name,database-name> \
  --table "[dbo].[Customers]" \
  --table "[dbo].[Orders]"

Přidejte tabulku prostřednictvím odkazu na připojení a po příkazovém řádku vyberte datovou sadu a tabulku:

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

Přidá akci Nebo funkci Dataverse do aplikace kódu.

pa app add dataverse-api --api-name <operation-name>

pa app add dataverse-api parametry

Parameter Description
--api-name Název akce Dataverse nebo funkce, které chcete přidat.

PA_CLI_DATAVERSE_API_NAME je odpovídající proměnná prostředí pro --api-name parametr.

Další informace:

pa app add flow

Přidá do aplikace kódu tok Power Automate.

pa app add flow --flow-id <flow-id>

pa app add flow parametry

Parameter Description
--flow-id ID toku Power Automate, který chcete přidat.

PA_CLI_FLOW_ID je odpovídající proměnná prostředí pro --flow-id parametr.

Příkaz:

  • Stáhne definici OpenAPI toku.
  • Generuje modely a služby TypeScript silného typu.
  • Přidá tok a jeho odkazy na připojení .power.config.json

Pokud se definice toku změní, spusťte tento příkaz znovu a znovu vygenerujte kód pro nejnovější verzi.

Important

Osoba, která běží pa app add flow , musí mít přístup k toku a jeho podkladovým připojením. Příkaz selže, pokud osoba nemá přístup k požadovanému připojení.

Další informace o scénářích, ve kterých používáte tento příkaz:

pa app find-dataverse-api

Najde akce a funkce Dataverse v aktuálním prostředí.

pa app find-dataverse-api --search <operation-name> [--json]

pa app find-dataverse-api parametry

Parameter Description
--search Název operace, který chcete vyhledat.
--json Vrátí výsledky jako JSON.

Tyto parametry odpovídají rozhraním API služby Dataverse a Power Automate toků proměnným prostředí.

Zjistěte, jak najít dostupné operace Dataverse.

pa app get-settings

Zobrazí aktuální nastavení pro aplikaci kódu.

pa app get-settings [--json]

pa app get-settings parametry

Parameter Description
--json Vraťte nastavení aplikace jako JSON.

Spusťte tento příkaz z inicializovaného projektu aplikace kódu, který obsahuje power.config.json soubor.

pa app init

Inicializuje aplikaci kódu v aktuálním adresáři.

pa app init [--display-name <name>] [--environment-id <environment-id>]

pa app init parametry

Parameter Description
--display-name Zobrazovaný název aplikace kódu.
--environment-id Prostředí Power Platform pro aplikaci kódu.
--description Popis aplikace kódu.
--build-path Adresář, který obsahuje zkompilované prostředky aplikace.
--file-entry-point Vstupní bod HTML ve výstupu sestavení.
--app-type Typ aplikace. Platné hodnoty jsou CodeApp a MobileApp.
--app-url Adresa URL místně spuštěné aplikace kódu.
--cloud Cloudová instance Power Platform.

Tyto parametry mají odpovídající proměnné prostředí inicializace aplikace .

Další informace o scénářích, ve kterých můžete použít tento příkaz:

pa app list

Zobrazí seznam aplikací kódu v aktuálním prostředí.

pa app list

pa app list-environment-variables

Zobrazí seznam proměnných prostředí dostupných pro aplikaci kódu.

pa app list-environment-variables

pa app list-flows

Obsahuje seznam Power Automate toků s podporou řešení v aktuálním prostředí.

pa app list-flows [--search <term>]

Příklad:

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 parametry

Parameter Description
--search Filtrování toků podle názvu

PA_CLI_FLOW_SEARCH je odpovídající proměnná prostředí pro --search parametr.

pa app push

Publikuje novou verzi aplikace kódu do Power Apps.

pa app push [--solution-id <solution-id>]

pa app push parametry

Parameter Description
--solution-id ID řešení pro přidání aplikace kódu do.
--non-interactive Publikuje aplikaci neinteraktivně. Naučte se publikovat aplikace pomocí instančního objektu.

Použije se PA_CLI_SOLUTION_ID jako proměnná prostředí s parametrem --solution-id .

Zjistěte, jak vytvořit aplikaci kódu pomocí rozhraní příkazového řádku Power Apps.

pa app refresh data-source

Aktualizuje vygenerované soubory pro zdroj dat.

pa app refresh data-source --name <data-source-name>

pa app refresh data-source parametry

Parameter Description
--name Název zdroje dat, který se má aktualizovat.

pa app remove data-source

Odebere zdroj dat z aplikace kódu.

pa app remove data-source --connector <connector-id> --name <data-source-name> [--force]

pa app remove data-source parametry

Parameter Description
--connector Identifikátor konektoru pro zdroj dat.
--name Název zdroje dat, který chcete odebrat.
--force Odeberte zdroj dat bez výzvy k potvrzení.

pa app remove flow

Odebere tok Power Automate z aplikace kódu.

pa app remove flow [--flow-name <name> | --flow-id <flow-id>] [--force]

pa app remove flow parametry

Parameter Description
--flow-name Název toku Power Automate, který chcete odebrat.
--flow-id ID toku Power Automate, který chcete odebrat.
--force Odeberte tok bez výzvy k potvrzení.

PA_CLI_FLOW_DATA_SOURCE_NAME a PA_CLI_REMOVE_FLOW_ID jsou odpovídající proměnné prostředí, které se mají s těmito parametry použít.

Zjistěte, jak tok odebrat.

pa app run

Spustí Power Apps místního hostitele aplikace kódu.

pa app run [--port <port>] [--local-app-url <url>]

pa app run parametry

Parameter Description
--port Port místního hostitele.
--local-app-url Adresa URL místně spuštěné aplikace kódu.

Tyto parametry mají odpovídající proměnné prostředí Spustit aplikace .

pa app set-setting

Aktualizuje jedno nebo více nastavení pro aplikaci kódu.

pa app set-setting --show-header <true|false> [--json]

pa app set-setting parametry

Parameter Description
--show-header Zobrazí nebo skryje záhlaví aplikace. Platné hodnoty jsou true a false.
--json Vrátí aktualizovaná nastavení aplikace jako JSON.

Spusťte tento příkaz z inicializovaného projektu aplikace kódu, který obsahuje power.config.json soubor. Příkaz zapíše nastavení do appSettingspower.config.jsonsouboru . Spuštěním pa app push publikujte nastavení tak, aby ho přehrávač použil za běhu.

pa app share

Sdílí aplikaci kódu s uživateli nebo instančními objekty.

pa app share --principal <principal> [--access play|edit]

pa app share parametry

Parameter Description
--principal E-mailové adresy oddělené čárkami nebo Microsoft Entra ID objektů pro uživatele nebo instanční objekty, se kterými se mají uživatelé nebo instanční objekty sdílet.
--access Úroveň přístupu, která se má udělit: play (výchozí) nebo edit.

Tyto parametry mají odpovídající proměnné prostředí Pro sdílení aplikací .

pa app share Poznámky

Aplikace kódu už musí být publikovaná a musí mít ID aplikace z úspěšného pa app push příkazu. Udělte edit přístup, když je potřeba spustit pa app pushinstanční objekt .

Při sdílení s instančním objektem použijte ID objektu podnikové aplikace, nikoli ID objektu registrace aplikace.

pa auth login

Přihlásí se v systémovém prohlížeči.

pa auth login

Pokud chcete předem vytvořit účet na přihlašovací stránce, použijte:

pa auth login --account user@contoso.com

pa auth login parametry

Parameter Description
--account Účet, který se má předem naplní na přihlašovací stránce.

PA_CLI_ACCOUNT je odpovídající proměnná prostředí pro --account parametr.

pa auth logout

Odhlásí se a odebere uložené ověřovací informace.

pa auth logout

Note

Tento příkaz vás odhlásí ze všech účtů. Nemůže se odhlásit jenom z jednoho účtu. Pokud chcete změnit účet, který je aktivní, použijte pa auth switch místo toho.

Zjistěte, jak se odhlásit

pa auth status

Zobrazí přihlášené účty a identifikuje aktivní účet.

Pokud chcete zobrazit stav ověřování ve formátu JSON, použijte:

pa auth status --json

pa auth status parametry

Parameter Description
--json Vrátí stav ověřování ve formátu JSON.

Zjistěte, jak zkontrolovat, který účet je aktivní.

pa auth switch

Změní aktivní účet.

pa auth switch --account user@contoso.com

pa auth switch parametry

Parameter Description
--account Účet, který se má aktivovat.

PA_CLI_ACCOUNT je odpovídající proměnná prostředí pro --account parametr.

Další informace o tom, kdy můžete použít tento příkaz:

pa connection create

Vytvoří připojení pro konektor.

pa connection create --connector <connector-id> [--display-name <name>] [--json]

pa connection create parametry

Parameter Alias Povinné Description
--connector - Ano Identifikátor konektoru, například shared_office365 nebo shared_teams.
--display-name -n No Zobrazovaný název připojení. Pokud nezadáte název, použije rozhraní příkazového řádku výchozí název.
--json - No Vrátí výsledek ve formátu JSON.

příklady pa connection create

Vytvořte připojení Office 365 Outlook:

pa connection create --connector shared_office365

Vytvořte připojení Microsoft Teams s vlastním zobrazovaným názvem:

pa connection create --connector shared_teams --display-name "My Teams"

Vytvořte připojení a vraťte výsledek ve formátu JSON:

pa connection create --connector shared_office365 --json

pa connection create výstup

Po úspěšném provedení příkazu vrátí ID připojení. ID připojení použijte, když do aplikace kódu přidáte konektor jako zdroj dat.

Zjistěte, jak vytvořit připojení z rozhraní příkazového řádku Power Apps

pa connection list

Zobrazí seznam připojení v aktuálním prostředí.

pa connection list [--search <term>] [--json]

pa connection list parametry

Parameter Description
--search Filtrování připojení podle názvu
--json Vrátí výsledky jako JSON.

Tyto parametry mají odpovídající proměnné prostředí řešení, konektorů a zdrojů dat .

pa connection list-datasets

Zobrazí seznam datových sad dostupných prostřednictvím připojení.

pa connection list-datasets --connector <connector-id> [--connection-id <connection-id>]

pa connection list-datasets parametry

Parameter Description
--connector Identifikátor konektoru.
--connection-id ID připojení, které se má použít při výpisu datových sad.

pa connection list-procedures

Uvádí seznam uložených procedur SQL dostupných v datové sadě.

pa connection list-procedures --connection-id <connection-id> --dataset <dataset>

pa connection list-procedures parametry

Parameter Description
--connection-id ID připojení, které se má použít při výpisu uložených procedur.
--dataset Datová sada, která obsahuje uložené procedury.

pa connection list-references

Vypíše odkazy na připojení v řešení.

pa connection list-references --solution-id <solution-id>

pa connection list-references parametry

Parameter Description
--solution-id ID řešení, které obsahuje odkazy na připojení.

Použije PA_CLI_SOLUTION_ID se s parametrem --solution-id .

pa connection list-tables

Zobrazí seznam tabulek dostupných v datové sadě.

pa connection list-tables --connector <connector-id> [--connection-id <connection-id>] [--dataset <dataset>]

pa connection list-tables parametry

Parameter Description
--connector Identifikátor konektoru.
--connection-id ID připojení, které se má použít při výpisu tabulek.
--dataset Datová sada, která obsahuje tabulky.

pa connector list

Uvádí seznam konektorů dostupných v aktuálním prostředí Power Platform.

pa connector list [--search <term>] [--json]

pa connector list parametry

Parameter Description
--search Filtrování konektorů podle názvu nebo zobrazovaného názvu
--json Vrátí úplný seznam konektorů jako JSON.

PA_CLI_CONNECTOR_SEARCH je odpovídající proměnná prostředí, která se má použít s parametrem --search .

pa connector list výstup

V interaktivním terminálu se zobrazí výsledky na stránkách 20 řádků. Stisknutím klávesy Enter zobrazte další stránku. Stisknutím klávesy Esc nebo Q ukončete. Při přesměrování výstupu nebo zahrnutí --jsonvrátí příkaz úplný seznam.

Ve výchozím nastavení příkaz vrátí tabulku s následujícími sloupci:

Column Description
Zobrazit název Zobrazovaný název konektoru, například Office 365 Outlook.
Spojnice Identifikátor konektoru, například shared_office365. Tuto hodnotu použijte s --connector možností pa connection create.

Při použití parametru --json obsahuje výstup JSON následující pole:

Pole Description
id ID konektoru.
name Identifikátor konektoru, například shared_office365.
displayName Zobrazovaný název konektoru.
description Popis konektoru.
isTabular Určuje, jestli konektor podporuje tabulkové operace s daty.

příklady pa connector list

Výpis všech dostupných konektorů:

pa connector list

Vyhledejte konektory:

pa connector list --search teams

Vrátí seznam konektorů jako JSON:

pa connector list --json

Zjistěte, jak zobrazit seznam dostupných konektorů.

pa solution list

Uvádí řešení v aktuálním prostředí, včetně popisného názvu, jedinečného názvu a ID řešení.

pa solution list [--search <term>] [--json]

pa solution list parametry

Parameter Description
--search Filtrování řešení podle popisného názvu nebo jedinečného názvu Filtr nerozlišuje malá a velká písmena.
--json Vrátí úplný seznam řešení jako JSON.

PA_CLI_SOLUTION_SEARCH je odpovídající proměnná prostředí pro --search parametr.

V interaktivním terminálu se zobrazí výsledky na stránkách 20 řádků. Stisknutím klávesy Enter zobrazte další stránku. Stisknutím klávesy Esc nebo Q ukončete. Při přesměrování výstupu nebo zahrnutí --jsonvrátí příkaz úplný seznam.

pa telemetry disable

Zakáže shromažďování telemetrie.

pa telemetry disable

pa telemetry enable

Povolí shromažďování telemetrie.

pa telemetry enable

pa telemetry status

Zobrazí aktuální nastavení telemetrie.

pa telemetry status
  • Poslední aktualizace v