informations de référence sur la commande CLI Power Apps

Utilisez cette Power Apps référence de commande CLI pour rechercher rapidement des commandes pour créer, développer, connecter et publier des applications de code Power Apps. L’interface CLI utilise des commandes groupées au format suivant :

pa <command-group> <command>

Voici les groupes de commandes :

Groupe de commandes Description
pa app Créez, exécutez, connectez et publiez des applications de code.
pa auth Connectez-vous et gérez les comptes.
pa connection Créez et gérez les connexions et découvrez leurs ressources.
pa connector Recherchez des connecteurs disponibles dans un environnement Power Platform.
pa solution Recherchez des solutions disponibles dans un environnement Power Platform.
pa telemetry Gérer les paramètres de télémétrie CLI.

Options globales

Utilisez à n’importe quel niveau pour afficher de --help l’aide dans le terminal :

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

Permet --version d’afficher la version de l’interface CLI installée Power Apps :

pa --version

commandes CLI Power Apps

Ces commandes sont disponibles :

Command Description
pa app add data-source Ajoutez un connecteur ou une source de données tabulaire à l’application de code.
pa app add dataverse-api Ajoutez une action ou une fonction Dataverse à l’application de code.
pa app add flow Ajoutez un flux Power Automate à l’application de code.
pa app find-dataverse-api Recherchez des actions et des fonctions Dataverse dans l’environnement actuel.
pa app get-settings Affichez les paramètres actuels de l’application.
pa app init Initialisez une application de code dans le répertoire actif.
pa app list Répertorier les applications de code dans l’environnement actuel.
pa app list-environment-variables Répertorier les variables d’environnement disponibles pour l’application de code.
pa app list-flows Répertoriez les flux Power Automate prenant en compte les solutions dans l’environnement actuel.
pa app push Publiez une nouvelle version de l’application de code sur Power Apps.
pa app refresh data-source Actualisez les fichiers générés pour une source de données.
pa app remove data-source Supprimez une source de données de l’application de code.
pa app remove flow Supprimez un flux Power Automate de l’application de code.
pa app run Démarrez l’hôte local Power Apps pour l’application de code.
pa app set-setting Mettez à jour les paramètres de l’application.
pa app share Partagez l’application de code avec des utilisateurs ou des principaux de service.
pa auth login Connectez-vous via le navigateur système.
pa auth logout Déconnectez-vous et supprimez les informations d’authentification enregistrées.
pa auth status Affichez les comptes connectés et identifiez le compte actif.
pa auth switch Modifiez le compte actif.
pa connection create Créez une connexion pour un connecteur.
pa connection list Répertorier les connexions dans l’environnement actuel.
pa connection list-datasets Répertorier les jeux de données disponibles via une connexion.
pa connection list-procedures Répertorier les procédures stockées SQL disponibles dans un jeu de données.
pa connection list-references Répertorier les références de connexion dans une solution.
pa connection list-tables Répertorier les tables disponibles dans un jeu de données.
pa connector list Répertorier les connecteurs disponibles dans l’environnement Power Platform actuel.
pa solution list Répertorier les solutions dans l’environnement actuel.
pa telemetry disable Désactivez la collecte de données de télémétrie.
pa telemetry enable Activer la collecte de données de télémétrie.
pa telemetry status Affichez les paramètres de télémétrie actuels.

pa app add data-source

Ajoute un connecteur ou une source de données tabulaire à l’application de code.

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

Paramètres pa app add data-source

Paramètre Description
--connector Identificateur du connecteur, tel que shared_office365users, ou le nom complet du connecteur, tel que "Utilisateurs d’Office 365". Si un nom d’affichage correspond à plusieurs connecteurs, la commande répertorie les identificateurs de connecteur correspondants afin que vous puissiez en spécifier un.
--as Indique s’il faut ajouter le connecteur en tant que source de données ou action en tant que table source de données. Utilisez ce paramètre avec des connecteurs qui prennent en charge les tables et les actions, telles que SharePoint et SQL Server. Pour plus d’informations, consultez pa app add data-source les remarques.
--connection-id ID de connexion à utiliser pour la source de données.
--connection-ref Nom logique d’une référence de connexion, par cr123_sharedsharepointonline_1a2b3exemple .
--solution-id Solution qui contient la référence de connexion.
--dataset Jeu de données pour une source de données tabulaire.
--table Tableau à ajouter. Répétez ce paramètre pour ajouter plusieurs tables à partir du même connecteur, connexion et jeu de données. Native Dataverse prend en charge une table par commande.
--org-url URL de l’organisation Dataverse utilisée pour récupérer les métadonnées de table Dataverse natives. En mode interactif, la commande demande cette valeur si vous ne la fournissez pas en tant qu’option de commande ou variable d’environnement.
--procedure Procédure stockée SQL à ajouter.

Ces paramètres ont des variables environnementales correspondantes solutions, connecteurs et sources de données .

pa app add data-source Remarques

Pour ajouter plusieurs tables de connecteurs dans une commande, répétez --table pour chaque table. Les tables doivent utiliser le même connecteur, la connexion et le même jeu de données. La commande ajoute des identificateurs de table en double une seule fois. Vous ne pouvez inclure qu’une seule table Dataverse native ou une procédure stockée SQL par commande.

Si une opération de métadonnées, de validation ou d’écriture de schéma spécifique à une table échoue, la commande ajoute toujours les tables valides. Il signale des résultats ordonnés succeeded et failed retourne un code de sortie différent de zéro en cas d’échec d’une table. Passez en revue les résultats avant de réessayer.

Certains connecteurs, tels que SharePoint et SQL Server, prennent en charge les tables et les actions. Pour ces connecteurs, spécifiez ce qui doit être ajouté :

  • Pour ajouter des tables ou une procédure stockée SQL, utilisez --as tableou incluez ou --procedure.--table
  • Pour ajouter les actions du connecteur, utilisez --as action. Vous ne pouvez pas utiliser --as action avec --dataset, --tableou --procedure.

Si vous ne spécifiez pas ce qu’il faut ajouter, la commande demande à Ajouter une table ? dans un terminal interactif. En mode non interactif, la commande échoue jusqu’à ce que vous spécifiiez --as. Les connecteurs qui prennent en charge uniquement les actions, telles que Utilisateurs d’Office 365, n'ont pas besoin --as et ne prennent pas en charge --as table. Pour ajouter des actions ou des fonctions Dataverse, utilisez pa app add dataverse-api plutôt --as actionque .

Dans un terminal interactif, la commande invite les valeurs requises que vous ne fournissez pas en tant qu’options de commande ou variables d’environnement. Les invites dépendent du type de source de données.

Pour dataverse natif :

  1. Si vous ne spécifiez --connectorpas, la commande demande l’ID du connecteur.
  2. La commande demande le nom logique de la table.
  3. La commande demande l’URL de l’organisation Dataverse lorsqu’elle n’est pas fournie.

Native Dataverse n’utilise pas d’ID de connexion, de référence de connexion ou de jeu de données.

Pour les sources de données sauvegardées par le connecteur :

Choisir le connecteur et le type de source de données

  1. Si vous ne spécifiez --connectorpas, la commande demande l’ID du connecteur.
  2. Si le connecteur prend en charge les tables et les actions et que rien d’autre ne détermine ce qu’il faut ajouter, la commande demande Ajouter une table ?

Choisir la connexion

La commande vous demande d’utiliser une référence de connexion au lieu d’un ID de connexion ? Il ignore cette question lorsque vous fournissez un ID de connexion ou une référence de connexion.

  • Si vous sélectionnez Oui, la commande demande le nom logique de référence de connexion.
  • Si vous sélectionnez Non, la commande répertorie vos connexions pour le connecteur. Sélectionnez (Entrer manuellement...) pour entrer un ID de connexion qui n’est pas dans la liste.

Choisir les données

  • Si vous ajoutez des actions, la commande ignore la procédure stockée, le jeu de données et les invites de table.

  • Si vous ajoutez des tables ou une procédure stockée :

    1. Pour SQL Server, la commande vous demande si vous ajoutez une procédure stockée. Si vous le faites, il demande le nom de la procédure stockée.
    2. La commande répertorie les jeux de données disponibles via la connexion. Sélectionnez (Entrer manuellement...) pour entrer un jeu de données qui n’est pas dans la liste.
    3. Sauf si vous ajoutez une procédure stockée, la commande ouvre une liste de tables pouvant faire l’objet d’une recherche dans le jeu de données. Vous pouvez sélectionner plusieurs tables.

Lorsque vous utilisez une référence de connexion, le jeu de données et les listes de tables proviennent de la connexion vers laquelle pointe la référence.

Exemples pa app add data-source

Ajoutez une source de données en répondant aux invites :

pa app add data-source

Ajoutez une table Dataverse native :

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

Ajoutez les actions d’un connecteur qui prend également en charge les tables :

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

Ajoutez une SharePoint list à l’aide du nom complet du connecteur :

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

Ajoutez plusieurs tables SQL à partir du même jeu de données :

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

Ajoutez une table par le biais d’une référence de connexion, puis sélectionnez le jeu de données et la table lorsque la commande invite :

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

Ajoute une action ou une fonction Dataverse à l’application de code.

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

Paramètres pa app add dataverse-api

Paramètre Description
--api-name Nom de l’action ou de la fonction Dataverse à ajouter.

PA_CLI_DATAVERSE_API_NAME est la variable d’environnement correspondante pour le --api-name paramètre.

Pour en savoir plus:

pa app add flow

Ajoute un flux Power Automate à l’application de code.

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

Paramètres pa app add flow

Paramètre Description
--flow-id ID du flux Power Automate à ajouter.

PA_CLI_FLOW_ID est la variable d’environnement correspondante pour le --flow-id paramètre.

Commande :

  • Télécharge la définition OpenAPI du flux.
  • Génère des modèles et des services TypeScript fortement typés.
  • Ajoute le flux et ses références de connexion à power.config.json.

Si une définition de flux change, réexécutez cette commande pour régénérer le code pour la dernière version.

Important

La personne qui s’exécute pa app add flow doit avoir accès au flux et à ses connexions sous-jacentes. La commande échoue si la personne n’a pas accès à une connexion requise.

En savoir plus sur les scénarios dans lesquels vous utilisez cette commande :

pa app find-dataverse-api

Recherche des actions et des fonctions Dataverse dans l’environnement actuel.

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

Paramètres pa app find-dataverse-api

Paramètre Description
--search Nom de l’opération à rechercher.
--json Retourne les résultats au format JSON.

Ces paramètres correspondent aux API Dataverse et Power Automate flux de variables environnementales.

Découvrez comment rechercher des opérations Dataverse disponibles.

pa app get-settings

Affiche les paramètres actuels de l’application de code.

pa app get-settings [--json]

Paramètres pa app get-settings

Paramètre Description
--json Retournez les paramètres de l’application au format JSON.

Exécutez cette commande à partir d’un projet d’application de code initialisé qui contient un power.config.json fichier.

pa app init

Initialise une application de code dans le répertoire actif.

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

Paramètres pa app init

Paramètre Description
--display-name Nom complet de l’application de code.
--environment-id Environnement Power Platform pour l’application de code.
--description Description de l’application de code.
--build-path Répertoire qui contient les ressources de l’application compilée.
--file-entry-point Point d’entrée HTML dans la sortie de build.
--app-type Type de l’application. Les valeurs valides sont CodeApp et MobileApp.
--app-url URL de l’application de code en cours d’exécution locale.
--cloud Instance cloud Power Platform.

Ces paramètres ont des variables environnementales d’initialisation d’application correspondantes.

En savoir plus sur les scénarios dans lesquels vous pouvez utiliser cette commande :

pa app list

Répertorie les applications de code dans l’environnement actuel.

pa app list

pa app list-environment-variables

Répertorie les variables d’environnement disponibles pour l’application de code.

pa app list-environment-variables

pa app list-flows

Répertorie les flux Power Automate prenant en compte les solutions dans l’environnement actuel.

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

Example:

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

Paramètres pa app list-flows

Paramètre Description
--search Filtrez les flux par nom.

PA_CLI_FLOW_SEARCH est la variable d’environnement correspondante pour le --search paramètre.

pa app push

Publie une nouvelle version de l’application de code sur Power Apps.

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

Paramètres pa app push

Paramètre Description
--solution-id ID de la solution à laquelle ajouter l’application de code.
--non-interactive Publie l’application de manière non interactive. Apprenez à publier des applications avec un principal de service.

Utilisez PA_CLI_SOLUTION_ID comme variable d’environnement avec le --solution-id paramètre.

Découvrez comment créer une application de code à l’aide de l’interface CLI Power Apps.

pa app refresh data-source

Actualise les fichiers générés pour une source de données.

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

Paramètres pa app refresh data-source

Paramètre Description
--name Nom de la source de données à actualiser.

pa app remove data-source

Supprime une source de données de l’application de code.

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

Paramètres pa app remove data-source

Paramètre Description
--connector Identificateur du connecteur pour la source de données.
--name Nom de la source de données à supprimer.
--force Supprimez la source de données sans demander de confirmation.

pa app remove flow

Supprime un flux Power Automate de l’application de code.

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

Paramètres pa app remove flow

Paramètre Description
--flow-name Nom du flux Power Automate à supprimer.
--flow-id ID du flux Power Automate à supprimer.
--force Supprimez le flux sans demander de confirmation.

PA_CLI_FLOW_DATA_SOURCE_NAME et PA_CLI_REMOVE_FLOW_ID sont des variables d’environnement correspondantes à utiliser avec ces paramètres.

Découvrez comment supprimer un flux.

pa app run

Démarre l’hôte local Power Apps pour l’application de code.

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

Paramètres pa app run

Paramètre Description
--port Port de l’hôte local.
--local-app-url URL de l’application de code en cours d’exécution locale.

Ces paramètres ont des variables environnementales Exécuter des applications correspondantes.

pa app set-setting

Met à jour un ou plusieurs paramètres pour l’application de code.

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

Paramètres pa app set-setting

Paramètre Description
--show-header Afficher ou masquer l’en-tête de l’application. Les valeurs valides sont true et false.
--json Retournez les paramètres d’application mis à jour en tant que JSON.

Exécutez cette commande à partir d’un projet d’application de code initialisé qui contient un power.config.json fichier. La commande écrit le paramètre dans appSettingspower.config.json. Exécutez pa app push pour publier le paramètre afin que le lecteur l’applique au moment de l’exécution.

pa app share

Partage l’application de code avec des utilisateurs ou des principaux de service.

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

Paramètres pa app share

Paramètre Description
--principal Adresses e-mail séparées par des virgules ou id d’objet Microsoft Entra pour les utilisateurs ou les principaux de service à partager.
--access Niveau d’accès à accorder : play (par défaut) ou edit.

Ces paramètres ont des variables environnementales Share Apps correspondantes.

pa app share Remarques

L’application de code doit déjà être publiée et avoir un ID d’application à partir d’une commande réussie pa app push . Accordez edit l’accès lorsqu’un principal de service doit s’exécuter pa app push.

Lors du partage avec un principal de service, utilisez l’ID d’objet Application d’entreprise, et non l’ID d’objet Inscription d’application.

pa auth login

Se connecte via le navigateur système.

pa auth login

Pour préremplir le compte sur la page de connexion, utilisez :

pa auth login --account user@contoso.com

Paramètres pa auth login

Paramètre Description
--account Compte à préremplir sur la page de connexion.

PA_CLI_ACCOUNT est la variable d’environnement correspondante pour le --account paramètre.

pa auth logout

Déconnecte et supprime les informations d’authentification enregistrées.

pa auth logout

Note

Cette commande vous déconnecte de tous les comptes. Il ne peut pas vous déconnecter d’un seul compte. Pour modifier le compte actif, utilisez pa auth switch plutôt.

Découvrez comment se déconnecter

pa auth status

Affiche les comptes connectés et identifie le compte actif.

Pour afficher l’état d’authentification au format JSON, utilisez :

pa auth status --json

Paramètres pa auth status

Paramètre Description
--json Retournez l’état d’authentification au format JSON.

Découvrez comment vérifier quel compte est actif

pa auth switch

Modifie le compte actif.

pa auth switch --account user@contoso.com

Paramètres pa auth switch

Paramètre Description
--account Compte à activer.

PA_CLI_ACCOUNT est la variable d’environnement correspondante pour le --account paramètre.

En savoir plus sur l’utilisation de cette commande :

pa connection create

Crée une connexion pour un connecteur.

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

Paramètres pa connection create

Paramètre Alias Obligatoire Description
--connector - Oui Identificateur du connecteur, tel que shared_office365 ou shared_teams.
--display-name -n Non Nom complet de la connexion. Si vous ne fournissez pas de nom, l’interface CLI utilise un nom par défaut.
--json - Non Retourne le résultat au format JSON.

Exemples pa connection create

Créez une connexion Office 365 Outlook :

pa connection create --connector shared_office365

Créez une connexion Microsoft Teams avec un nom d’affichage personnalisé :

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

Créez une connexion et retournez le résultat au format JSON :

pa connection create --connector shared_office365 --json

pa connection create sortie

Lorsque la commande réussit, elle retourne l’ID de connexion. Utilisez l’ID de connexion lorsque vous ajoutez le connecteur en tant que source de données à l’application de code.

Découvrez comment créer une connexion à partir de l’interface CLI Power Apps

pa connection list

Répertorie les connexions dans l’environnement actuel.

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

Paramètres pa connection list

Paramètre Description
--search Filtrez les connexions par nom.
--json Retourne les résultats au format JSON.

Ces paramètres ont des variables environnementales correspondantes solutions, connecteurs et sources de données .

pa connection list-datasets

Répertorie les jeux de données disponibles via une connexion.

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

Paramètres pa connection list-datasets

Paramètre Description
--connector Identificateur du connecteur.
--connection-id ID de connexion à utiliser lors de la liste des jeux de données.

pa connection list-procedures

Répertorie les procédures stockées SQL disponibles dans un jeu de données.

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

Paramètres pa connection list-procedures

Paramètre Description
--connection-id ID de connexion à utiliser lors de la liste des procédures stockées.
--dataset Jeu de données qui contient les procédures stockées.

pa connection list-references

Répertorie les références de connexion dans une solution.

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

Paramètres pa connection list-references

Paramètre Description
--solution-id ID de la solution qui contient les références de connexion.

Utiliser PA_CLI_SOLUTION_ID avec le --solution-id paramètre.

pa connection list-tables

Répertorie les tables disponibles dans un jeu de données.

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

Paramètres pa connection list-tables

Paramètre Description
--connector Identificateur du connecteur.
--connection-id ID de connexion à utiliser lors de la liste des tables.
--dataset Jeu de données qui contient les tables.

pa connector list

Répertorie les connecteurs disponibles dans l’environnement Power Platform actuel.

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

Paramètres pa connector list

Paramètre Description
--search Filtrez les connecteurs par nom ou nom d’affichage.
--json Retournez la liste complète des connecteurs au format JSON.

PA_CLI_CONNECTOR_SEARCH est la variable d’environnement correspondante à utiliser avec le --search paramètre.

pa connector list sortie

Dans un terminal interactif, vous voyez les résultats dans les pages de 20 lignes. Appuyez sur Entrée pour afficher la page suivante. Appuyez sur Échap ou Q pour quitter. Lorsque vous redirigez la sortie ou incluez --json, la commande retourne la liste complète.

Par défaut, la commande retourne une table avec les colonnes suivantes :

Column Description
Nom d’affichage Nom complet du connecteur, tel que Office 365 Outlook.
Connector Identificateur du connecteur, tel que shared_office365. Utilisez cette valeur avec l’option --connectorpa connection create.

Lorsque vous utilisez le --json paramètre, la sortie JSON inclut les champs suivants :

Champ Description
id ID du connecteur.
name Identificateur du connecteur, tel que shared_office365.
displayName Nom complet du connecteur.
description Description du connecteur.
isTabular Indique si le connecteur prend en charge les opérations de données tabulaires.

Exemples pa connector list

Répertorier tous les connecteurs disponibles :

pa connector list

Recherchez des connecteurs :

pa connector list --search teams

Retournez la liste des connecteurs au format JSON :

pa connector list --json

Découvrez comment répertorier les connecteurs disponibles

pa solution list

Répertorie les solutions dans l’environnement actuel, y compris leur nom convivial, leur nom unique et leur ID de solution.

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

Paramètres pa solution list

Paramètre Description
--search Filtrez les solutions par nom convivial ou nom unique. Le filtre est une correspondance de sous-chaîne ne respectant pas la casse.
--json Retournez la liste complète des solutions au format JSON.

PA_CLI_SOLUTION_SEARCH est la variable d’environnement correspondante pour le --search paramètre.

Dans un terminal interactif, vous voyez les résultats dans les pages de 20 lignes. Appuyez sur Entrée pour afficher la page suivante. Appuyez sur Échap ou Q pour quitter. Lorsque vous redirigez la sortie ou incluez --json, la commande retourne la liste complète.

pa telemetry disable

Désactive la collecte de données de télémétrie.

pa telemetry disable

pa telemetry enable

Active la collecte de données de télémétrie.

pa telemetry enable

pa telemetry status

Affiche les paramètres de télémétrie actuels.

pa telemetry status
  • Dernière mise à jour :