Créer une connexion depuis l’interface de ligne de commande (CLI) (aperçu)

Utilisez la commande bibliothèque cliente Power Apps pour les applications de codecreate-connection pour créer une connexion à un connecteur directement à partir de la ligne de commande, sans quitter votre terminal ni ouvrir Power Apps, comme décrit dans Procédure : connecter votre application de code à des données.

À compter de la version 1.2.7, utilisez la list-connectors commande pour afficher les connecteurs disponibles dans votre environnement.

Prerequisites

Une application de code Power Apps initialisée. Consultez démarrage rapide : Créer une application de code à l’aide de l’interface CLI npm.

Répertorier les connecteurs disponibles

Avant de créer une connexion, utilisez la list-connectors commande pour voir quels connecteurs sont disponibles dans votre environnement Power Platform et pour rechercher l’identificateur d’API d’un connecteur. Il s’agit de la valeur que vous passez à l’option create-connection de commande api-id .

La list-connectors commande répertorie les connecteurs de l’environnement Power Platform que votre application de code cible actuellement. Il s’agit de l’environnement défini dans power.config.json lorsque vous avez exécuté power-apps init.

Usage

Exécutez la commande à partir de la racine de votre projet d’application de code :

power-apps list-connectors [--search <term>] [--json]

Options

Utilisez les options suivantes avec list-connectors.

Option	Alias	Obligatoire	Description
--search	-s	Non	Filtrez les résultats pour n’afficher que les connecteurs dont le nom ou le nom d’affichage correspond au terme de recherche.
--json	—	Non	Affichez la liste complète des connecteurs au format JSON pour les scénarios de script.

Sortie

Par défaut, la commande imprime une table avec deux colonnes :

Column	Description
Nom d’affichage	Nom convivial du connecteur, par exemple, Office 365 Outlook.
Connecteur	Nom unique /identificateur d’API du connecteur, par exemple shared_office365. Il s’agit de la valeur que vous passez à l’option create-connection de commande --api-id .

Lorsque vous exécutez la commande dans un terminal interactif, elle retourne des résultats dans des pages de 20 lignes. Appuyez sur Entrée pour afficher la page suivante, ou échap/q pour quitter. Lorsque vous redirigez la sortie (non interactive) ou que vous passez --json, la commande émet la liste complète à la fois.

La --json sortie inclut des champs supplémentaires pour chaque connecteur au-delà des deux colonnes de table :

Champ	Description
id	ID du connecteur.
name	Nom unique du connecteur (identificateur d’API), par exemple shared_office365.
displayName	Nom d’affichage convivial du connecteur.
description	Description du connecteur.
isTabular	Indique si le connecteur prend en charge les opérations de données tabulaires (table).

Examples

Répertoriez tous les connecteurs disponibles dans l’environnement actuel :

power-apps list-connectors

Recherchez les connecteurs par nom :

power-apps list-connectors --search teams

Émettez la liste complète des connecteurs au format JSON. Cela est utile dans les scripts et l’intégration continue (CI) :

power-apps list-connectors --json

Créer la connexion

Utilisez la create-connection commande pour créer une connexion pour un connecteur directement à partir de la ligne de commande, sans quitter votre terminal ou ouvrir le portail Power Apps maker.

La connexion est créée dans l’environnement Power Platform que votre application de code cible actuellement. Cet environnement est défini dans power.config.json lors de l’exécution de power-apps init.

Usage

Exécutez la commande à partir de la racine de votre projet d’application de code :

power-apps create-connection --api-id <connectorId> [--display-name <name>] [--json]

Options

Utilisez les options suivantes avec create-connection.

Option	Alias	Obligatoire	Description
--api-id	-a	Oui	Identificateur de l’API du connecteur (par exemple, shared_office365, shared_teams).
--display-name	-n	Non	Nom d’affichage facultatif pour la nouvelle connexion. S’il n’est pas spécifié, une valeur par défaut est utilisée.
--json	—	Non	Affichez le résultat au format JSON pour les scénarios de script.

Examples

Créez une connexion Office 365 :

power-apps create-connection --api-id shared_office365

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

power-apps create-connection --api-id shared_teams --display-name "My Teams"

Créez une connexion et émettez une sortie JSON. Cela est utile dans les scripts et l’intégration continue (CI) :

power-apps create-connection --api-id shared_office365 --json

En cas de réussite, la commande imprime l’ID de la nouvelle connexion. Vous pouvez ensuite référencer cet ID de connexion lors de l’ajout du connecteur en tant que source de données à votre application de code.