Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez des variables d’environnement pour configurer Power Apps l’authentification CLI et fournir des options de commande dans les scripts et les pipelines CI/CD. Les variables d’environnement définies par l’interface CLI Power Apps utilisent le PA_CLI_ préfixe.
Note
Les variables d’environnement sont des valeurs nommées que le système d’exploitation met à la disposition des applications. Power Apps CLI reconnaît les variables décrites dans cette référence. Pour savoir comment fonctionnent les variables d’environnement et comment les gérer, consultez les variables d’environnement.
Cette référence décrit les variables d’environnement du système d’exploitation qui configurent l’interface CLI Power Apps. Ces variables sont différentes des variables d’environnement de solution Power Platform, qui stockent les valeurs de configuration utilisées par une application.
Pour une option de commande, l’interface CLI résout une valeur dans cet ordre :
- Option de ligne de commande
- Variable d'environnement
- Valeur par défaut, si l’option en a une
- Invite interactive, quand elle est prise en charge
Une option fournie sur la ligne de commande est prioritaire sur sa variable d’environnement correspondante.
Important
Les variables d’environnement peuvent exposer des secrets à d’autres processus, journaux ou historique de l’interpréteur de commandes. Stockez PA_CLI_SP_CLIENT_SECRET dans le magasin de secrets de votre plateforme CI/CD, masquez-le à partir des journaux et ne validez pas les secrets dans le contrôle de code source.
Définir des variables d’environnement
Les exemples suivants sont définis PA_CLI_ENVIRONMENT_ID avant d’exécuter une commande CLI Power Apps.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
La variable d’environnement reste disponible pour les commandes démarrées à partir de la même session de terminal. Utilisez la commande standard de votre interpréteur de commandes pour la supprimer lorsqu’elle n’est plus nécessaire.
Authentification
| Variable d'environnement | Description |
|---|---|
PA_CLI_ACCOUNT |
Spécifie le compte pour pa auth login ou pa auth switch. |
PA_CLI_SP_CLIENT_ID |
Spécifie l’ID d’application Microsoft Entra (client) pour l’authentification du principal de service. |
PA_CLI_SP_CLIENT_SECRET |
Spécifie la clé secrète client pour l’authentification du principal de service. |
PA_CLI_SP_TENANT_ID |
Spécifie l’ID d’annuaire Microsoft Entra (locataire) pour l’authentification du principal de service. |
PA_CLI_USE_SP_AUTH |
Définissez la valeur true sur (minuscules) pour utiliser l’authentification du principal de service. |
Les trois PA_CLI_SP_variables d’informations d’identification * sont requises lorsque l’authentification du principal de service est sélectionnée. Bien qu’elle CI=true sélectionne également l’authentification du principal de service pour la compatibilité, utilisez cette option PA_CLI_USE_SP_AUTH=true pour rendre le mode d’authentification explicite.
Pour obtenir des instructions de configuration, consultez Publier Power Apps applications de code avec un principal de service.
Options de commande globale
Ces variables correspondent aux options disponibles dans Power Apps commandes CLI.
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
Sélectionne le cloud cible. Les valeurs valides sont les suivantes : - public (par défaut)- usgov- usgovhigh- usgovdod- chinaLes valeurs ne respectent pas la casse. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
Spécifie l’ID d’environnement Power Platform cible. |
Initialisation d’application
Ces variables fournissent des options à pa app init.
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
Spécifie le répertoire de sortie de build. La valeur par défaut est ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
Spécifie la description de l’application. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
Spécifie le nom complet de l’application. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
Spécifie le point d’entrée HTML dans la sortie de build. La valeur par défaut est index.html. |
PA_CLI_APP_TYPE |
--app-type |
Spécifie le type d’application. Les valeurs valides sont les suivantes : - CodeApp (par défaut)- MobileAppLa valeur est enregistrée et utilisée comme power.config.json type d’application lors de la publication de l’application. |
PA_CLI_APP_URL |
--app-url |
Spécifie l’URL de l’application locale pendant pa app init. La valeur est enregistrée comme localAppUrl dans power.config.json et devient l’URL par défaut pour les commandes futures pa app run . La valeur par défaut est http://localhost:3000. |
Exécuter des applications
Ces variables fournissent des options à pa app run.
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
Remplace la localAppUrl valeur de power.config.json la commande actuelle sans modifier la configuration enregistrée. Si aucune valeur n’est définie, la valeur par défaut est http://localhost:3000. |
PA_CLI_PORT |
--port |
Spécifie le port de l’hôte local Power Apps. La valeur par défaut est 8080. |
Partager des applications
Ces variables fournissent des options à pa app share.
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
Spécifie le niveau d’accès. Les valeurs valides sont les suivantes : - play (par défaut)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
Spécifie une ou plusieurs adresses e-mail séparées par des virgules ou Microsoft Entra ID d’objet. |
Solutions, connecteurs et sources de données
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
Spécifie le nom complet lors de la création d’une connexion. |
PA_CLI_CONNECTION_ID |
--connection-id |
Spécifie un ID d’instance de connexion de connecteur. |
PA_CLI_CONNECTION_REF |
--connection-ref |
Spécifie un nom logique de référence de connexion. |
PA_CLI_CONNECTION_SEARCH |
--search |
Filtre les résultats de pa connection list. |
PA_CLI_CONNECTOR |
--connector |
Spécifie un ID de connecteur, tel que shared_office365users. |
PA_CLI_CONNECTOR_SEARCH |
--search |
Filtre les résultats de pa connector list. |
PA_CLI_DATASET |
--dataset |
Spécifie un jeu de données, tel qu’un site SharePoint ou une base de données SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
Spécifie la source de données à actualiser ou à supprimer. |
PA_CLI_ORG_URL |
--org-url |
Remplace l’URL de l’organisation Dataverse utilisée pour récupérer les métadonnées lors de l’ajout d’une source de données. |
PA_CLI_PROCEDURE |
--procedure |
Spécifie une procédure stockée SQL. |
PA_CLI_SOLUTION_ID |
--solution-id |
Spécifie la solution pour pa app push, pa app add data-sourceou pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
Filtre les résultats de pa solution list. |
PA_CLI_TABLE |
--table |
Spécifie un nom de ressource de table ou de connecteur. |
Pour connaître les commandes qui acceptent chaque option, consultez la référence de commande cli Power Apps.
Api dataverse et flux de Power Automate
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
Spécifie l’action ou la fonction Dataverse à ajouter avec l’application pa ajouter dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
Filtre les actions et fonctions Dataverse par nom avec pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
Spécifie la source de données de flux à supprimer de l’application avec pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
Spécifie le flux Power Automate à ajouter avec pa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
Filtre les flux de Power Automate disponibles par nom avecpa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
Spécifie le flux Power Automate à supprimer avecpa app remove flow |
Télémétrie et sortie de la console
| Variable d'environnement | Option correspondante | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
Définissez la valeur true sur (minuscules) avec pa telemetry enable ou pa telemetry disable pour écrire des données de télémétrie uniquement dans la console et ne l’envoyez pas à distance. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
Définissez la valeur true sur (minuscules) avec pa telemetry enable ou pa telemetry disable pour mettre en miroir les événements de télémétrie envoyés à distance à la console. |
PA_CLI_TELEMETRY |
None | Définissez l’une de ces valeurs pour désactiver la télémétrie pour le processus actuel : - 0- false- no- offLes valeurs ne respectent pas la casse et les espaces environnants sont ignorés. |
Pour connaître les paramètres de télémétrie persistants, consultez Gérer les paramètres de télémétrie pour l’interface CLI Power Apps.
Variables d’environnement standard
L’interface CLI observe également cette variable d’environnement standard :
| Variable d'environnement | Description |
|---|---|
NO_COLOR |
Définissez cette variable sur une valeur sansmpty pour désactiver la sortie de couleur ANSI. Vous pouvez également utiliser l’option --no-color . |