Power Apps CLI-omgevingsvariabelen

Gebruik omgevingsvariabelen om Power Apps CLI-verificatie te configureren en opdrachtopties te bieden in scripts en CI/CD-pijplijnen. Omgevingsvariabelen die zijn gedefinieerd door de Power Apps CLI, gebruiken het PA_CLI_ voorvoegsel.

Note

Omgevingsvariabelen zijn benoemde waarden die het besturingssysteem beschikbaar maakt voor toepassingen. Power Apps CLI herkent de variabelen die in deze verwijzing worden beschreven. Zie voor meer informatie over hoe omgevingsvariabelen werken en hoe u deze beheert , over omgevingsvariabelen.

In deze verwijzing worden omgevingsvariabelen van het besturingssysteem beschreven waarmee de Power Apps CLI wordt geconfigureerd. Deze variabelen verschillen van omgevingsvariabelen van de Power Platform-oplossing, waarin configuratiewaarden worden opgeslagen die door een app worden gebruikt.

Voor een opdrachtoptie wordt in de CLI een waarde in deze volgorde omgezet:

  1. Opdrachtregeloptie
  2. Omgevingsvariabele
  3. Standaardwaarde, als de optie er een heeft
  4. Interactieve prompt, indien ondersteund

Een optie die op de opdrachtregel wordt opgegeven, heeft voorrang op de bijbehorende omgevingsvariabele.

Important

Omgevingsvariabelen kunnen geheimen beschikbaar maken voor andere processen, logboeken of shellgeschiedenis. Sla PA_CLI_SP_CLIENT_SECRET deze op in het geheime archief van uw CI/CD-platform, masker deze uit logboeken en voer geen geheimen door naar broncodebeheer.

Omgevingsvariabelen instellen

De volgende voorbeelden zijn ingesteld PA_CLI_ENVIRONMENT_ID voordat u een Power Apps CLI-opdracht uitvoert.

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

De omgevingsvariabele blijft beschikbaar voor opdrachten die zijn gestart vanaf dezelfde terminalsessie. Gebruik de standaardopdracht van uw shell om deze te verwijderen wanneer deze niet meer nodig is.

Authentication

Omgevingsvariabele Description
PA_CLI_ACCOUNT Hiermee geeft u het account voor pa auth login of pa auth switch.
PA_CLI_SP_CLIENT_ID Hiermee geeft u de Microsoft Entra toepassings-id (client) voor service-principal-verificatie.
PA_CLI_SP_CLIENT_SECRET Hiermee geeft u het clientgeheim voor service-principal-verificatie.
PA_CLI_SP_TENANT_ID Hiermee geeft u de Microsoft Entra directory-id (tenant) voor service-principal-verificatie.
PA_CLI_USE_SP_AUTH Stel de waarde in op true (kleine letters) om service-principalverificatie te gebruiken.

De drie PA_CLI_SP_* referentievariabelen zijn vereist wanneer verificatie van de service-principal is geselecteerd. Hoewel CI=true ook service-principalverificatie wordt geselecteerd voor compatibiliteit, gebruikt PA_CLI_USE_SP_AUTH=true u deze om de verificatiemodus expliciet te maken.

Zie Publiceren Power Apps code-apps met een service-principal voor installatie-instructies.

Algemene opdrachtopties

Deze variabelen komen overeen met opties die beschikbaar zijn in Power Apps CLI-opdrachten.

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_CLOUD --cloud Selecteert de doelcloud. Geldige waarden zijn:
- public (standaard)
- usgov
- usgovhigh
- usgovdod
- china
Waarden zijn niet hoofdlettergevoelig.
PA_CLI_ENVIRONMENT_ID --environment-id Hiermee geeft u de doelomgevings-id van Power Platform op.

App-initialisatie

Deze variabelen bieden opties voor pa app init.

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_APP_BUILD_PATH --build-path Hiermee geeft u de build-uitvoermap. De standaardwaarde is ./dist.
PA_CLI_APP_DESCRIPTION --description Hiermee geeft u de beschrijving van de app.
PA_CLI_APP_DISPLAY_NAME --display-name Hiermee geeft u de weergavenaam van de app op.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Hiermee geeft u het HTML-invoerpunt in de build-uitvoer. De standaardwaarde is index.html.
PA_CLI_APP_TYPE --app-type Hiermee geeft u het app-type op. Geldige waarden zijn:
- CodeApp (standaard)
- MobileApp
De waarde wordt opgeslagen in power.config.json en gebruikt als het app-type wanneer de app wordt gepubliceerd.
PA_CLI_APP_URL --app-url Hiermee geeft u de URL van de lokale app tijdens pa app init. De waarde wordt opgeslagen als localAppUrl in power.config.json en wordt de standaard-URL voor toekomstige pa app run opdrachten. De standaardwaarde is http://localhost:3000.

Apps uitvoeren

Deze variabelen bieden opties voor pa app run.

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_LOCAL_APP_URL --local-app-url Overschrijft de localAppUrl waarde voor power.config.json de huidige opdracht zonder de opgeslagen configuratie te wijzigen. Als geen van beide waarden is ingesteld, is de standaardwaarde http://localhost:3000.
PA_CLI_PORT --port Hiermee geeft u de poort voor de Power Apps lokale host. De standaardwaarde is 8080.

Apps delen

Deze variabelen bieden opties voor pa app share.

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_SHARE_ACCESS --access Hiermee geeft u het toegangsniveau op. Geldige waarden zijn:
- play (standaard)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Hiermee geeft u een of meer door komma's gescheiden e-mailadressen of Microsoft Entra object-id's.

Oplossingen, connectors en gegevensbronnen

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Hiermee geeft u de weergavenaam op bij het maken van een verbinding.
PA_CLI_CONNECTION_ID --connection-id Hiermee geeft u een verbindingsexemplaren-id op.
PA_CLI_CONNECTION_REF --connection-ref Hiermee geeft u een logische naam voor een verbindingsreferentie op.
PA_CLI_CONNECTION_SEARCH --search Filtert resultaten van pa connection list.
PA_CLI_CONNECTOR --connector Hiermee geeft u een connector-id op, zoals shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtert resultaten van pa connector list.
PA_CLI_DATASET --dataset Hiermee geeft u een gegevensset op, zoals een SharePoint-site of SQL-database.
PA_CLI_DATA_SOURCE_NAME --name Hiermee geeft u de gegevensbron op die moet worden vernieuwd of verwijderd.
PA_CLI_ORG_URL --org-url Hiermee overschrijft u de URL van de Dataverse-organisatie die wordt gebruikt om metagegevens op te halen bij het toevoegen van een gegevensbron.
PA_CLI_PROCEDURE --procedure Hiermee geeft u een opgeslagen SQL-procedure op.
PA_CLI_SOLUTION_ID --solution-id Hiermee geeft u de oplossing voor pa app push, pa app add data-sourceof pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtert resultaten van pa solution list.
PA_CLI_TABLE --table Hiermee geeft u een tabel- of connectorresourcenaam op.

Zie de Power Apps CLI-opdrachtreferentie voor de opdrachten die elke optie accepteren.

Dataverse-API's en Power Automate stromen

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_DATAVERSE_API_NAME --api-name Hiermee geeft u de Dataverse-actie of -functie op die moet worden toegevoegd met pa-app dataverse-API.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtert Dataverse-acties en -functies op naam met pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Hiermee geeft u de stroomgegevensbron op die uit de app moet worden verwijderd met pa app remove flow
PA_CLI_FLOW_ID --flow-id Hiermee geeft u de Power Automate stroom toe te voegen met pa app add flow.
PA_CLI_FLOW_SEARCH --search Hiermee filtert u de beschikbare Power Automate stromen op naam metpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Hiermee geeft u de Power Automate stroom die moet worden verwijderd metpa app remove flow

Telemetrie en console-uitvoer

Omgevingsvariabele Bijbehorende optie Description
PA_CLI_CONSOLE_ONLY --console-only Stel de waarde in op true (kleine letters) met pa telemetry enable of pa telemetry disable schrijf telemetrie alleen naar de console en verzend deze niet op afstand.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Stel de waarde in op true (kleine letters) met pa telemetry enable of pa telemetry disable om extern verzonden telemetrie-gebeurtenissen naar de console te spiegelen.
PA_CLI_TELEMETRY Geen Stel een van deze waarden in om telemetrie uit te schakelen voor het huidige proces:
- 0
- false
- no
- off
Waarden zijn niet hoofdlettergevoelig en omringende spaties worden genegeerd.

Zie Telemetrie-instellingen beheren voor de Power Apps CLI voor permanente telemetrie-instellingen.

Standaardomgevingsvariabelen

De CLI ziet ook deze standaardomgevingsvariabele:

Omgevingsvariabele Description
NO_COLOR Stel deze variabele in op een lege waarde om ANSI-kleuruitvoer uit te schakelen. U kunt ook de --no-color optie gebruiken.
  • Last updated on