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

À compter de Power Apps bibliothèque cliente pour les applications de code version 1.1.9, la nouvelle interface CLI npm inclut une commande create-connection. Utilisez cette 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 (l’environnement défini lors power.config.json de l’exécution power-apps init).

Prerequisites

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

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 (utile dans les scripts et 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.

Limites

  • Seule la création de connexion SSO non interactive est prise en charge. La commande create-connection aboutit uniquement pour les connecteurs dont le seul type d’authentification est compatible avec l’authentification unique (SSO), généralement des connecteurs basés sur Microsoft Entra ID tels que Office 365 Outlook, SharePoint, OneDrive Entreprise et Microsoft Teams.
  • Les connecteurs qui nécessitent des informations d’identification ou une configuration fournies par l’utilisateur ne sont pas pris en charge. Les exemples incluent SQL Server avec l’authentification SQL, les connecteurs personnalisés qui nécessitent des clés API et tous les connecteurs qui exposent plusieurs méthodes d’authentification pour l’utilisateur parmi lesquelles choisir. Pour créer ces connexions, utilisez le portail Power Apps maker à la place.