Partager via

pac connector

  • Article

Commandes pour utiliser des connecteurs Power Platform

Commandes

Command Description
création de connecteur pac Crée une nouvelle ligne dans la table Connecteur de Dataverse.
Téléchargement du connecteur pac Télécharger le fichier des propriétés d’API et OpenApiDefinition d’un connecteur
initialisation du connecteur pac Initialise un nouveau fichier de propriétés d’API pour un connecteur.
liste des connecteurs pac Répertoriez les connecteurs enregistrés dans Dataverse.
mise à jour du connecteur pac Met à jour une entité de connecteur dans Dataverse.

pac connector create

Crée une nouvelle ligne dans la table Connecteur de Dataverse.

Examples

Les exemples suivants illustrent l’utilisation de la commande pac connector create.

Création de connecteur de base dans l’environnement actuel

Cet exemple crée un connecteur dans l’environnement de votre profil d’authentification actuellement actif.

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json

Création de connecteur de base dans l’environnement spécifié

Cet exemple crée un connecteur dans l’environnement spécifié.

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json
  --environment 00000000-0000-0000-0000-000000000000

Paramètres facultatifs pour connector create

--api-definition-file-df

Nom de fichier et chemin d’accès pour lire le fichier OpenApiDefinition du connecteur.

--api-properties-file-pf

Nom de fichier et chemin d’accès pour lire le fichier des propriétés d’API du connecteur.

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--icon-file-if

Nom de fichier et chemin d’accès vers un fichier d’icône .png.

--script-file-sf

Nom de fichier et chemin d’accès à un fichier Script .csx.

--settings-file

Nom de fichier et chemin d’accès au fichier des paramètres de connecteur.

--solution-unique-name-sol

Nom unique de la solution auquel ajouter le connecteur

pac connector download

Télécharger le fichier des propriétés d’API et OpenApiDefinition d’un connecteur

Examples

Les exemples suivants illustrent l’utilisation de la commande pac connector download.

Téléchargement du connecteur de base

Cet exemple télécharge le connecteur spécifié dans le répertoire courant.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000

Téléchargement du connecteur de base depuis l’environnement spécifié

Cet exemple télécharge le connecteur spécifié depuis l’environnement spécifié dans le répertoire courant.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000

Téléchargement du connecteur de base depuis l’environnement spécifié vers le répertoire spécifié

Cet exemple télécharge le connecteur spécifié depuis l’environnement spécifié dans le répertoire spécifié.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000 `
  --outputDirectory "contoso_Connector"

Paramètres obligatoires pour connector download

--connector-id-id

ID du connecteur

Remarque : l’ID du connecteur doit être un GUID valide.

Paramètres facultatifs pour connector download

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--outputDirectory-o

Répertoire de sortie

pac connector init

Initialise un nouveau fichier de propriétés d’API pour un connecteur.

Exemple

L’exemple suivant illustre l’utilisation de la commande pac connector init.

Connecteur init avec répertoire de sortie et modèle de connexion pour l’authentification Microsoft Entra ID OAuth

Cet exemple initialise un connecteur dans le répertoire actuel.

pac connector init `
  --connection-template "OAuthAAD" `
  --generate-script-file `
  --generate-settings-file `
  --outputDirectory "contoso_Connector"

Paramètres facultatifs pour connector init

--connection-template-ct

Génère un ensemble initial de paramètres de connexion avec le modèle spécifié.

Utilisez l’une de ces valeurs :

  • NoAuth
  • BasicAuth
  • ApiKey
  • OAuthGeneric
  • OAuthAAD

--generate-script-file

Générer un fichier script initial de connecteur

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--generate-settings-file

Générer un fichier de paramètres initial de connecteur

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--outputDirectory-o

Répertoire de sortie

pac connector list

Répertoriez les connecteurs enregistrés dans Dataverse.

Examples

Les exemples suivants illustrent l’utilisation de la commande pac connector list.

Répertorier les connecteurs dans l’environnement actuel

Cet exemple répertorie tous les connecteurs dans l’environnement de votre profil d’authentification actuellement actif.

pac connector list

Répertorier les connecteurs dans l’environnement spécifié

Cet exemple dresse une liste de tous les connecteurs dans cet environnement spécifié.

pac connector list `
  --environment 00000000-0000-0000-0000-000000000000

Paramètres facultatifs pour connector list

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--json

Renvoie la sortie de la commande sous la forme d’une chaîne au format JSON.

Remarques

Seuls les connecteurs compatibles avec la solution sont affichés. Lorsque votre connecteur ne figure pas dans la réponse de cette commande, cela est probablement dû au fait que votre connecteur n’est pas compatible avec la solution.

pac connector update

Met à jour une entité de connecteur dans Dataverse.

Examples

Les exemples suivants illustrent l’utilisation de la commande pac connector update.

Mise à jour du connecteur de base dans l’environnement actuel

Cet exemple met à jour un connecteur dans l’environnement de votre profil d’authentification actuellement actif.

pac connector update `
  --api-definition-file ./apiDefinition.json

Mise à jour du connecteur de base dans l’environnement spécifié

Cet exemple met à jour un connecteur dans l’environnement spécifié.

pac connector update `
  --api-definition-file ./apiDefinition.json `
  --environment 00000000-0000-0000-0000-000000000000

Paramètres facultatifs pour connector update

--api-definition-file-df

Nom de fichier et chemin d’accès pour lire le fichier OpenApiDefinition du connecteur.

--api-properties-file-pf

Nom de fichier et chemin d’accès pour lire le fichier des propriétés d’API du connecteur.

--connector-id-id

ID du connecteur

Remarque : l’ID du connecteur doit être un GUID valide.

--environment-env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--icon-file-if

Nom de fichier et chemin d’accès vers un fichier d’icône .png.

--script-file-sf

Nom de fichier et chemin d’accès à un fichier Script .csx.

--settings-file

Nom de fichier et chemin d’accès au fichier des paramètres de connecteur.

--solution-unique-name-sol

Nom unique de la solution auquel ajouter le connecteur

Voir aussi

Microsoft Power Platform Groupes de commandes CLI
Microsoft Power Platform Présentation de la CLI