kommandoreferanse for Power Apps CLI

Bruk denne Power Apps CLI-kommandoreferansen til raskt å finne kommandoer for å opprette, utvikle, koble til og publisere Power Apps kodeapper. Cli bruker grupperte kommandoer i følgende format:

pa <command-group> <command>

Dette er kommandogruppene:

Kommandogruppe Beskrivelse
pa app Opprett, kjør, koble til og publiser kodeapper.
pa auth Logg på og administrer kontoer.
pa connection Opprett og administrer tilkoblinger, og oppdag ressursene deres.
pa connector Finn koblinger som er tilgjengelige i et Power Platform-miljø.
pa solution Finn løsninger som er tilgjengelige i et Power Platform-miljø.
pa telemetry Behandle innstillinger for CLI-telemetri.

Globale alternativer

Bruk --help på alle nivåer til å vise hjelp i terminalen:

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

Brukes --version til å vise den installerte Power Apps CLI-versjonen:

pa --version

Power Apps CLI-kommandoer

Disse kommandoene er tilgjengelige:

Kommando Beskrivelse
pa app add data-source Legg til en kobling eller tabelldatakilde i kodeappen.
pa app add dataverse-api Legg til en datavers handling eller funksjon i kodeappen.
pa app add flow Legg til en Power Automate flyt i kodeappen.
pa app find-dataverse-api Finn dataverse handlinger og funksjoner i gjeldende miljø.
pa app get-settings Vis gjeldende appinnstillinger.
pa app init Initialiser en kodeapp i gjeldende katalog.
pa app list Vis kodeapper i gjeldende miljø.
pa app list-environment-variables Listemiljøvariabler som er tilgjengelige for kodeappen.
pa app list-flows Vis løsningsavhengige Power Automate flyter i gjeldende miljø.
pa app push Publiser en ny versjon av kodeappen for å Power Apps.
pa app refresh data-source Oppdater de genererte filene for en datakilde.
pa app remove data-source Fjern en datakilde fra kodeappen.
pa app remove flow Fjern en Power Automate flyt fra kodeappen.
pa app run Start den Power Apps lokale verten for kodeappen.
pa app set-setting Oppdater appinnstillinger.
pa app share Del kodeappen med brukere eller tjenestekontohavere.
pa auth login Logg på via systemleseren.
pa auth logout Logg av og fjern lagret godkjenningsinformasjon.
pa auth status Vis påloggede kontoer og identifiser den aktive kontoen.
pa auth switch Endre den aktive kontoen.
pa connection create Opprett en tilkobling for en kobling.
pa connection list Vis tilkoblinger i gjeldende miljø.
pa connection list-datasets Vis datasett som er tilgjengelige via en tilkobling.
pa connection list-procedures Vis SQL-lagrede prosedyrer som er tilgjengelige i et datasett.
pa connection list-references Vis tilkoblingsreferanser i en løsning.
pa connection list-tables Listetabeller som er tilgjengelige i et datasett.
pa connector list Listekoblinger som er tilgjengelige i gjeldende Power Platform-miljø.
pa solution list Vis løsninger i gjeldende miljø.
pa telemetry disable Deaktiver telemetrisamling.
pa telemetry enable Aktiver telemetrisamling.
pa telemetry status Vis gjeldende telemetriinnstillinger.

pa app add data-source

Legger til en kobling eller tabelldatakilde i kodeappen.

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

pa app add data-source Parametere

Parameteren Beskrivelse
--connector Koblingsidentifikatoren, for eksempel shared_office365users, eller koblingsvisningsnavnet, for eksempel "Office 365-brukere". Hvis et visningsnavn samsvarer med mer enn én kobling, viser kommandoen de samsvarende koblingsidentifikatorene slik at du kan angi en.
--as Om du vil legge til koblingen som en table eller en action datakilde. Bruk denne parameteren med koblinger som støtter både tabeller og handlinger, for eksempel SharePoint og SQL Server. Hvis du vil ha mer informasjon, kan du se pa app add data-source merknader.
--connection-id Tilkoblings-IDen som skal brukes for datakilden.
--connection-ref Det logiske navnet på en tilkoblingsreferanse, for eksempel cr123_sharedsharepointonline_1a2b3.
--solution-id Løsningen som inneholder tilkoblingsreferansen.
--dataset Datasettet for en tabelldatakilde.
--table Tabellen du vil legge til. Gjenta denne parameteren for å legge til flere tabeller fra samme kobling, tilkobling og datasett. Opprinnelig datavers støtter én tabell per kommando.
--org-url Url-adressen for dataverse organisasjoner som brukes til å hente opprinnelige dataverse tabellmetadata. I interaktiv modus ber kommandoen om denne verdien hvis du ikke oppgir den som et kommandoalternativ eller miljøvariabel.
--procedure Den lagrede SQL-prosedyren som skal legges til.

Disse parameterne har tilsvarende løsninger, koblinger og datakilder for miljøvariabler.

pa app add data-source Merknader

Hvis du vil legge til flere koblingstabeller i én kommando, gjentar du --table for hver tabell. Tabellene må bruke samme kobling, tilkobling og datasett. Kommandoen legger til dupliserte tabellidentifikatorer bare én gang. Du kan bare inkludere én opprinnelig datavers tabell eller SQL-lagret prosedyre per kommando.

Hvis en tabellspesifikk metadata-, validerings- eller skjemaskrivingsoperasjon mislykkes, legger kommandoen fortsatt til de gyldige tabellene. Den rapporterer sortert succeeded og failed resultater og returnerer en ikke-null-avslutningskode hvis en tabell mislykkes. Se gjennom resultatene før du prøver på nytt.

Noen koblinger, for eksempel SharePoint og SQL Server, støtter både tabeller og handlinger. Angi hva du vil legge til for disse koblingene:

  • Hvis du vil legge til tabeller eller en SQL-lagret prosedyre, bruker --as tabledu eller inkluderer --table eller --procedure.
  • Hvis du vil legge til koblingens handlinger, bruker du --as action. Du kan ikke bruke --as action med --dataset, --tableeller --procedure.

Hvis du ikke angir hva du vil legge til, spør kommandoen Legg til en tabell? i en interaktiv terminal. Kommandoen mislykkes i ikke-interaktiv modus til du angir --as. Koblinger som bare støtter handlinger, for eksempel Office 365-brukere, trenger --as ikke og støtter --as tableikke . Hvis du vil legge til dataverse handlinger eller funksjoner, bruker pa app add dataverse-api du i stedet --as actionfor .

I en interaktiv terminal ber kommandoen om nødvendige verdier som du ikke oppgir som kommandoalternativer eller miljøvariabler. Ledetekstene avhenger av datakildetypen.

For opprinnelig datavers:

  1. Hvis du ikke angir --connectordet, ber kommandoen om koblings-ID-en.
  2. Kommandoen ber om det logiske navnet på tabellen.
  3. Kommandoen ber om nettadressen til dataverseorganisasjonen når den ikke er angitt.

Opprinnelig datavers bruker ikke tilkoblings-ID, tilkoblingsreferanse eller datasett.

For datakilder med koblingsstøtte:

Velg koblings- og datakildetypen

  1. Hvis du ikke angir --connectordet, ber kommandoen om koblings-ID-en.
  2. Hvis koblingen støtter både tabeller og handlinger, og ingenting annet bestemmer hva du skal legge til, spør kommandoen Legg til en tabell?

Velg tilkoblingen

Kommandoen spør Bruker du en tilkoblingsreferanse i stedet for en tilkoblings-ID? Det hopper over dette spørsmålet når du oppgir en tilkoblings-ID eller tilkoblingsreferanse.

  • Hvis du velger Ja, ber kommandoen om det logiske navnet på tilkoblingsreferansen.
  • Hvis du velger Nei, viser kommandoen tilkoblingene for koblingen. Velg (Angi manuelt...) for å angi en tilkoblings-ID som ikke finnes i listen.

Velg dataene

  • Hvis du legger til handlinger, hopper kommandoen over den lagrede prosedyren, datasettet og tabellledetekstene.

  • Hvis du legger til tabeller eller en lagret prosedyre:

    1. For SQL Server spør kommandoen om du legger til en lagret prosedyre. Hvis du er det, ber den om navnet på den lagrede prosedyren.
    2. Kommandoen viser datasettene som er tilgjengelige via tilkoblingen. Velg (Skriv inn manuelt...) for å angi et datasett som ikke er i listen.
    3. Med mindre du legger til en lagret prosedyre, åpner kommandoen en søkbar liste over tabeller i datasettet. Du kan velge mer enn én tabell.

Når du bruker en tilkoblingsreferanse, kommer datasettet og tabelllistene fra tilkoblingen som referansen peker til.

pa app add data-source Eksempler

Legg til en datakilde ved å svare på ledetekster:

pa app add data-source

Legg til en opprinnelig datavers tabell:

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

Legg til handlingene til en kobling som også støtter tabeller:

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

Legg til en SharePoint list ved hjelp av visningsnavnet for koblingen:

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

Legg til flere SQL-tabeller fra samme datasett:

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

Legg til en tabell gjennom en tilkoblingsreferanse, og velg datasettet og tabellen når du blir bedt om det:

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

Legger til en datavers handling eller funksjon i kodeappen.

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

pa app add dataverse-api Parametere

Parameteren Beskrivelse
--api-name Navnet på datavershandlingen eller funksjonen som skal legges til.

PA_CLI_DATAVERSE_API_NAME er den tilsvarende miljøvariabelen for parameteren --api-name .

Finn ut mer:

pa app add flow

Legger til en Power Automate flyt i kodeappen.

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

pa app add flow Parametere

Parameteren Beskrivelse
--flow-id ID-en for Power Automate flyten som skal legges til.

PA_CLI_FLOW_ID er den tilsvarende miljøvariabelen for parameteren --flow-id .

Kommandoen:

  • Laster ned flytens OpenAPI-definisjon.
  • Genererer sterkt skrevne TypeScript-modeller og -tjenester.
  • Legger til flyten og tilkoblingsreferansene i power.config.json.

Hvis en flytdefinisjon endres, kjører du denne kommandoen på nytt for å generere kode på nytt for den nyeste versjonen.

Important

Personen som kjører pa app add flow , må ha tilgang til flyten og de underliggende tilkoblingene. Kommandoen mislykkes hvis personen ikke har tilgang til en nødvendig tilkobling.

Finn ut mer om scenarioer der du bruker denne kommandoen:

pa app find-dataverse-api

Finner dataverse handlinger og funksjoner i gjeldende miljø.

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

pa app find-dataverse-api Parametere

Parameteren Beskrivelse
--search Operasjonsnavnet du vil søke etter.
--json Returner resultatene som JSON.

Disse parameterne tilsvarer dataverse API-er og Power Automate flyter miljøvariabler.

Finn ut hvordan du finner tilgjengelige dataverseoperasjoner.

pa app get-settings

Viser gjeldende innstillinger for kodeappen.

pa app get-settings [--json]

pa app get-settings Parametere

Parameteren Beskrivelse
--json Returner appinnstillingene som JSON.

Kjør denne kommandoen fra et initialisert kodeappprosjekt som inneholder en power.config.json fil.

pa app init

Initialiserer en kodeapp i gjeldende katalog.

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

pa app init Parametere

Parameteren Beskrivelse
--display-name Visningsnavnet for kodeappen.
--environment-id Power Platform-miljøet for kodeappen.
--description Beskrivelsen av kodeappen.
--build-path Katalogen som inneholder de kompilerte appressursene.
--file-entry-point HTML-inngangspunktet i build-utdataene.
--app-type Apptypen. Gyldige verdier er CodeApp og MobileApp.
--app-url URL-adressen til den lokalt kjørende kodeappen.
--cloud Power Platform-skyforekomsten.

Disse parameterne har tilsvarende miljøvariabler for appinitiering .

Finn ut mer om scenarioer der du kan bruke denne kommandoen:

pa app list

Viser kodeapper i gjeldende miljø.

pa app list

pa app list-environment-variables

Viser miljøvariabler som er tilgjengelige for kodeappen.

pa app list-environment-variables

pa app list-flows

Viser løsningsavhengige Power Automate flyter i gjeldende miljø.

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

Eksempel:

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 Parametere

Parameteren Beskrivelse
--search Filtrer flyter etter navn.

PA_CLI_FLOW_SEARCH er den tilsvarende miljøvariabelen for parameteren --search .

pa app push

Publiserer en ny versjon av kodeappen for å Power Apps.

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

pa app push Parametere

Parameteren Beskrivelse
--solution-id ID-en for løsningen du vil legge til kodeappen i.
--non-interactive Publiserer appen ikke interaktivt. Lær hvordan du publiserer apper med en tjenestekontohaver.

Bruk PA_CLI_SOLUTION_ID som miljøvariabel med parameteren --solution-id .

Lær hvordan du oppretter en kodeapp ved hjelp av Power Apps CLI.

pa app refresh data-source

Oppdaterer de genererte filene for en datakilde.

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

pa app refresh data-source Parametere

Parameteren Beskrivelse
--name Navnet på datakilden som skal oppdateres.

pa app remove data-source

Fjerner en datakilde fra kodeappen.

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

pa app remove data-source Parametere

Parameteren Beskrivelse
--connector Koblingsidentifikatoren for datakilden.
--name Navnet på datakilden som skal fjernes.
--force Fjern datakilden uten å be om bekreftelse.

pa app remove flow

Fjerner en Power Automate flyt fra kodeappen.

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

pa app remove flow Parametere

Parameteren Beskrivelse
--flow-name Navnet på Power Automate flyten som skal fjernes.
--flow-id ID-en for Power Automate flyten som skal fjernes.
--force Fjern flyten uten å be om bekreftelse.

PA_CLI_FLOW_DATA_SOURCE_NAME og PA_CLI_REMOVE_FLOW_ID er tilsvarende miljøvariabler som skal brukes med disse parameterne.

Lær hvordan du fjerner en flyt.

pa app run

Starter den Power Apps lokale verten for kodeappen.

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

pa app run Parametere

Parameteren Beskrivelse
--port Porten for den lokale verten.
--local-app-url URL-adressen til den lokalt kjørende kodeappen.

Disse parameterne har tilsvarende miljøvariabler for Kjør apper .

pa app set-setting

Oppdaterer én eller flere innstillinger for kodeappen.

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

pa app set-setting Parametere

Parameteren Beskrivelse
--show-header Vis eller skjul toppteksten for appen. Gyldige verdier er true og false.
--json Returner de oppdaterte appinnstillingene som JSON.

Kjør denne kommandoen fra et initialisert kodeappprosjekt som inneholder en power.config.json fil. Kommandoen skriver innstillingen til appSettings i power.config.json. Kjør pa app push for å publisere innstillingen slik at spilleren bruker den ved kjøring.

pa app share

Deler kodeappen med brukere eller tjenestekontohavere.

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

pa app share Parametere

Parameteren Beskrivelse
--principal Kommadelte e-postadresser eller Microsoft Entra objekt-ID-er for brukere eller tjenestekontohavere å dele med.
--access Tilgangsnivået som skal gis: play (standard) eller edit.

Disse parameterne har tilsvarende miljøvariabler for Share Apps .

pa app share Merknader

Kodeappen må allerede være publisert og ha en app-ID fra en vellykket pa app push kommando. Gi edit tilgang når en tjenestekontohaver må kjøre pa app push.

Når du deler med en tjenestekontohaver, bruker du objekt-ID-en for enterprise-programmet, ikke objekt-ID-en for appregistrering.

pa auth login

Logger på via systemleseren.

pa auth login

Hvis du vil forhåndsutfylle kontoen på påloggingssiden, bruker du:

pa auth login --account user@contoso.com

pa auth login Parametere

Parameteren Beskrivelse
--account Kontoen som skal forhåndsutfylles på påloggingssiden.

PA_CLI_ACCOUNT er den tilsvarende miljøvariabelen for parameteren --account .

pa auth logout

Logger av og fjerner lagret godkjenningsinformasjon.

pa auth logout

Note

Denne kommandoen logger deg av alle kontoer. Den kan ikke logge deg av bare én konto. Hvis du vil endre hvilken konto som er aktiv, bruker du pa auth switch i stedet.

Finn ut hvordan du logger av

pa auth status

Viser påloggede kontoer og identifiserer den aktive kontoen.

Hvis du vil vise godkjenningsstatus som JSON, bruker du:

pa auth status --json

pa auth status Parametere

Parameteren Beskrivelse
--json Returner godkjenningsstatusen som JSON.

Finn ut hvordan du kontrollerer hvilken konto som er aktiv

pa auth switch

Endrer den aktive kontoen.

pa auth switch --account user@contoso.com

pa auth switch Parametere

Parameteren Beskrivelse
--account Kontoen som skal aktiveres.

PA_CLI_ACCOUNT er den tilsvarende miljøvariabelen for parameteren --account .

Lær mer om når du kan bruke denne kommandoen:

pa connection create

Oppretter en tilkobling for en kobling.

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

pa connection create Parametere

Parameteren Alias Påkrevd Beskrivelse
--connector - Ja Koblingsidentifikatoren, for eksempel shared_office365 eller shared_teams.
--display-name -n Nei Visningsnavnet for tilkoblingen. Hvis du ikke angir et navn, bruker CLI et standardnavn.
--json - Nei Returnerer resultatet som JSON.

pa connection create Eksempler

Opprett en Office 365 Outlook tilkobling:

pa connection create --connector shared_office365

Opprett en Microsoft Teams tilkobling med et egendefinert visningsnavn:

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

Opprett en tilkobling, og returner resultatet som JSON:

pa connection create --connector shared_office365 --json

pa connection create utdata

Når kommandoen lykkes, returnerer den tilkoblings-ID-en. Bruk tilkoblings-ID-en når du legger til koblingen som en datakilde i kodeappen.

Finn ut hvordan du oppretter en tilkobling fra Power Apps CLI

pa connection list

Viser tilkoblinger i gjeldende miljø.

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

pa connection list Parametere

Parameteren Beskrivelse
--search Filtrer tilkoblinger etter navn.
--json Returner resultatene som JSON.

Disse parameterne har tilsvarende løsninger, koblinger og datakilder for miljøvariabler.

pa connection list-datasets

Viser datasett som er tilgjengelige via en tilkobling.

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

pa connection list-datasets Parametere

Parameteren Beskrivelse
--connector Koblingsidentifikatoren.
--connection-id Tilkoblings-ID-en som skal brukes når du viser datasett.

pa connection list-procedures

Viser SQL-lagrede prosedyrer som er tilgjengelige i et datasett.

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

pa connection list-procedures Parametere

Parameteren Beskrivelse
--connection-id Tilkoblings-ID-en som skal brukes når du viser lagrede prosedyrer.
--dataset Datasettet som inneholder de lagrede prosedyrene.

pa connection list-references

Viser tilkoblingsreferanser i en løsning.

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

pa connection list-references Parametere

Parameteren Beskrivelse
--solution-id ID-en for løsningen som inneholder tilkoblingsreferansene.

Bruk PA_CLI_SOLUTION_ID med parameteren --solution-id .

pa connection list-tables

Viser tabeller som er tilgjengelige i et datasett.

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

pa connection list-tables Parametere

Parameteren Beskrivelse
--connector Koblingsidentifikatoren.
--connection-id Tilkoblings-ID-en som skal brukes når tabeller vises.
--dataset Datasettet som inneholder tabellene.

pa connector list

Viser koblinger som er tilgjengelige i gjeldende Power Platform-miljø.

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

pa connector list Parametere

Parameteren Beskrivelse
--search Filtrer koblinger etter navn eller visningsnavn.
--json Returner den fullstendige koblingslisten som JSON.

PA_CLI_CONNECTOR_SEARCH er den tilsvarende miljøvariabelen som skal brukes med parameteren --search .

pa connector list utdata

I en interaktiv terminal ser du resultater på sider med 20 rader. Trykk enter for å vise neste side. Trykk ESC eller Q for å avslutte. Når du omdirigerer utdataene eller inkluderingen --json, returnerer kommandoen den fullstendige listen.

Kommandoen returnerer som standard en tabell med følgende kolonner:

Column Beskrivelse
Visningsnavn Koblingens visningsnavn, for eksempel Office 365 Outlook.
Kobling Koblingsidentifikatoren, for eksempel shared_office365. Bruk denne verdien med --connector alternativet pa connection create.

Når du bruker parameteren --json , inkluderer JSON-utdataene følgende felt:

Felt Beskrivelse
id Koblings-ID-en.
name Koblingsidentifikatoren, for eksempel shared_office365.
displayName Visningsnavnet for koblingen.
description Koblingsbeskrivelsen.
isTabular Angir om koblingen støtter tabelldataoperasjoner.

pa connector list Eksempler

Vis alle tilgjengelige koblinger:

pa connector list

Søk etter koblinger:

pa connector list --search teams

Returner koblingslisten som JSON:

pa connector list --json

Finn ut hvordan du viser tilgjengelige koblinger

pa solution list

Viser en liste over løsninger i gjeldende miljø, inkludert egendefinert navn, unikt navn og løsnings-ID.

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

pa solution list Parametere

Parameteren Beskrivelse
--search Filtrer løsninger etter egendefinert navn eller unikt navn. Filteret er et skille mellom store og små bokstaver i delstrenger.
--json Returner den fullstendige løsningslisten som JSON.

PA_CLI_SOLUTION_SEARCH er den tilsvarende miljøvariabelen for parameteren --search .

I en interaktiv terminal ser du resultater på sider med 20 rader. Trykk enter for å vise neste side. Trykk ESC eller Q for å avslutte. Når du omdirigerer utdataene eller inkluderingen --json, returnerer kommandoen den fullstendige listen.

pa telemetry disable

Deaktiverer telemetrisamling.

pa telemetry disable

pa telemetry enable

Aktiverer telemetrisamling.

pa telemetry enable

pa telemetry status

Viser gjeldende telemetriinnstillinger.

pa telemetry status