Power Apps CLI-Umgebungsvariablen

Verwenden Sie Umgebungsvariablen, um Power Apps CLI-Authentifizierung zu konfigurieren und Befehlsoptionen in Skripts und CI/CD-Pipelines bereitzustellen. Durch die Power Apps CLI definierte Umgebungsvariablen verwenden das PA_CLI_ Präfix.

Note

Umgebungsvariablen sind benannte Werte, die vom Betriebssystem für Anwendungen zur Verfügung gestellt werden. Power Apps CLI erkennt die in dieser Referenz beschriebenen Variablen. Informationen dazu, wie Umgebungsvariablen funktionieren und wie sie verwaltet werden, finden Sie unter "Umgebungsvariablen".

In dieser Referenz werden Betriebssystemumgebungsvariablen beschrieben, die die Power Apps CLI konfigurieren. Diese Variablen unterscheiden sich von Power Platform-Lösungsumgebungsvariablen, die konfigurationswerte speichern, die von einer App verwendet werden.

Bei einer Befehlsoption löst die CLI einen Wert in dieser Reihenfolge auf:

  1. Befehlszeilenoption
  2. Umgebungsvariable
  3. Standardwert, wenn die Option eine hat
  4. Interaktive Eingabeaufforderung, wenn unterstützt

Eine option, die in der Befehlszeile bereitgestellt wird, hat Vorrang vor der entsprechenden Umgebungsvariable.

Important

Umgebungsvariablen können geheime Schlüssel für andere Prozesse, Protokolle oder Shellverlauf verfügbar machen. Speichern Sie im geheimen Speicher Ihrer CI/CD-Plattform, maskieren Sie PA_CLI_SP_CLIENT_SECRET ihn aus Protokollen, und übernehmen Sie keine geheimen Schlüssel zur Quellcodeverwaltung.

Festlegen von Umgebungsvariablen

Die folgenden Beispiele werden vor dem Ausführen eines Power Apps CLI-Befehls festgelegtPA_CLI_ENVIRONMENT_ID.

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

Die Umgebungsvariable bleibt für Befehle verfügbar, die von derselben Terminalsitzung gestartet wurden. Verwenden Sie den Standardbefehl Ihrer Shell, um ihn zu entfernen, wenn er nicht mehr benötigt wird.

Authentifizierung

Umgebungsvariable Description
PA_CLI_ACCOUNT Gibt das Konto für pa auth login oder pa auth switch.
PA_CLI_SP_CLIENT_ID Gibt die Microsoft Entra Anwendungs-ID (Client)-ID für die Dienstprinzipalauthentifizierung an.
PA_CLI_SP_CLIENT_SECRET Gibt den geheimen Clientschlüssel für die Dienstprinzipalauthentifizierung an.
PA_CLI_SP_TENANT_ID Gibt die Microsoft Entra Verzeichnis-ID (Mandanten-ID) für die Dienstprinzipalauthentifizierung an.
PA_CLI_USE_SP_AUTH Legen Sie den Wert auf true (Kleinbuchstabe) fest, um die Dienstprinzipalauthentifizierung zu verwenden.

Die drei PA_CLI_SP_* Anmeldeinformationsvariablen sind erforderlich, wenn die Dienstprinzipalauthentifizierung ausgewählt ist. Obwohl CI=true auch die Dienstprinzipalauthentifizierung zur Kompatibilität ausgewählt wird, wird PA_CLI_USE_SP_AUTH=true der Authentifizierungsmodus explizit verwendet.

Anweisungen zum Einrichten finden Sie unter Veröffentlichen Power Apps Code-Apps mit einem Dienstprinzipal.

Globale Befehlsoptionen

Diese Variablen entsprechen Optionen, die in Power Apps CLI-Befehlen verfügbar sind.

Umgebungsvariable Entsprechende Option Description
PA_CLI_CLOUD --cloud Wählt die Zielcloud aus. Gültige Werte sind:
- public (Standard)
- usgov
- usgovhigh
- usgovdod
- china
Bei Werten wird die Groß-/Kleinschreibung nicht beachtet.
PA_CLI_ENVIRONMENT_ID --environment-id Gibt die Ziel-Power Platform-Umgebungs-ID an.

App-Initialisierung

Diese Variablen liefern Optionen für pa app init.

Umgebungsvariable Entsprechende Option Description
PA_CLI_APP_BUILD_PATH --build-path Gibt das Buildausgabeverzeichnis an. Der Standardwert lautet ./dist.
PA_CLI_APP_DESCRIPTION --description Gibt die App-Beschreibung an.
PA_CLI_APP_DISPLAY_NAME --display-name Gibt den Anzeigenamen der App an.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Gibt den HTML-Einstiegspunkt in der Buildausgabe an. Der Standardwert lautet index.html.
PA_CLI_APP_TYPE --app-type Gibt den App-Typ an. Gültige Werte sind:
- CodeApp (Standard)
- MobileApp
Der Wert wird beim Veröffentlichen der App als power.config.json App-Typ gespeichert und verwendet.
PA_CLI_APP_URL --app-url Gibt die lokale App-URL während pa app initder Ausführung an. Der Wert wird wie localAppUrl in power.config.json gespeichert und wird zur Standard-URL für zukünftige pa app run Befehle. Der Standardwert lautet http://localhost:3000.

Ausführen von Apps

Diese Variablen liefern Optionen für pa app run.

Umgebungsvariable Entsprechende Option Description
PA_CLI_LOCAL_APP_URL --local-app-url Überschreibt den localAppUrl Wert power.config.json für den aktuellen Befehl, ohne die gespeicherte Konfiguration zu ändern. Wenn kein Wert festgelegt ist, lautet http://localhost:3000der Standardwert .
PA_CLI_PORT --port Gibt den Port für den Power Apps lokalen Host an. Der Standardwert lautet 8080.

Freigeben von Apps

Diese Variablen liefern Optionen für pa app share.

Umgebungsvariable Entsprechende Option Description
PA_CLI_SHARE_ACCESS --access Gibt die Zugriffsebene an. Gültige Werte sind:
- play (Standard)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Gibt eine oder mehrere kommagetrennte E-Mail-Adressen oder Microsoft Entra Objekt-IDs an.

Lösungen, Connectors und Datenquellen

Umgebungsvariable Entsprechende Option Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Gibt den Anzeigenamen beim Erstellen einer Verbindung an.
PA_CLI_CONNECTION_ID --connection-id Gibt eine Verbindungsinstanz-ID an.
PA_CLI_CONNECTION_REF --connection-ref Gibt einen logischen Verbindungsverweisnamen an.
PA_CLI_CONNECTION_SEARCH --search Filtert Ergebnisse aus pa connection list.
PA_CLI_CONNECTOR --connector Gibt eine Connector-ID an, z shared_office365users. B. .
PA_CLI_CONNECTOR_SEARCH --search Filtert Ergebnisse aus pa connector list.
PA_CLI_DATASET --dataset Gibt ein Dataset an, z. B. eine SharePoint Website oder SQL-Datenbank.
PA_CLI_DATA_SOURCE_NAME --name Gibt die Datenquelle an, die aktualisiert oder entfernt werden soll.
PA_CLI_ORG_URL --org-url Überschreibt die Dataverse-Organisations-URL zum Abrufen von Metadaten beim Hinzufügen einer Datenquelle.
PA_CLI_PROCEDURE --procedure Gibt eine gespeicherte SQL-Prozedur an.
PA_CLI_SOLUTION_ID --solution-id Gibt die Lösung für pa app push, , pa app add data-sourceoder pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtert Ergebnisse aus pa solution list.
PA_CLI_TABLE --table Gibt einen Tabellen- oder Verbinderressourcennamen an.

Informationen zu den Befehlen, die jede Option akzeptieren, finden Sie in der Power Apps CLI-Befehlsreferenz.

Dataverse-APIs und Power Automate-Flüsse

Umgebungsvariable Entsprechende Option Description
PA_CLI_DATAVERSE_API_NAME --api-name Gibt die Dataverse-Aktion oder -Funktion an, die mit pa app add dataverse-api hinzugefügt werden soll.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtert Dataverse-Aktionen und -Funktionen nach Namen mit pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Gibt die Flussdatenquelle an, die aus der App entfernt werden soll. pa app remove flow
PA_CLI_FLOW_ID --flow-id Gibt den Power Automate Fluss an, der hinzugefügt pa app add flowwerden soll.
PA_CLI_FLOW_SEARCH --search Filtert die verfügbaren Power Automate Flüsse nach Namen mitpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Gibt den zu entfernenden Power Automate Fluss an.pa app remove flow

Telemetrie- und Konsolenausgabe

Umgebungsvariable Entsprechende Option Description
PA_CLI_CONSOLE_ONLY --console-only Legen Sie den Wert auf true (Kleinbuchstabe) fest, mit pa telemetry enable oder pa telemetry disable schreiben Sie Telemetrie nur in die Konsole, und senden Sie ihn nicht remote.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Legen Sie den Wert auf true (Kleinbuchstaben) mit pa telemetry enable oder pa telemetry disable um remote gesendete Telemetrieereignisse in die Konsole zu spiegeln.
PA_CLI_TELEMETRY Nichts Legen Sie einen der folgenden Werte fest, um telemetrie für den aktuellen Prozess zu deaktivieren:
- 0
- false
- no
- off
Bei Werten wird die Groß-/Kleinschreibung nicht beachtet, und umgebende Leerzeichen werden ignoriert.

Informationen zu beständigen Telemetrieeinstellungen finden Sie unter Verwalten von Telemetrieeinstellungen für die Power Apps CLI.

Standardumgebungsvariablen

Die CLI beachtet auch diese Standardumgebungsvariable:

Umgebungsvariable Description
NO_COLOR Legen Sie diese Variable auf einen wert ungleichen Wert fest, um die ANSI-Farbausgabe zu deaktivieren. Sie können auch die --no-color Option verwenden.
  • Last updated on