pac connector

  • Article

Commandes pour utiliser des connecteurs Power Platform

Commandes

Command Description
pac connector create Crée une nouvelle ligne dans la table Connecteur de Dataverse.
pac connector download Télécharger le fichier des propriétés d’API et OpenApiDefinition d’un connecteur
pac connector init Initialise un nouveau fichier de propriétés d’API pour un connecteur.
pac connector list Répertoriez les connecteurs enregistrés dans Dataverse.
pac connector update 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 un répertoire de sortie et un modèle de connexion pour l’authentification OAuth Microsoft Entra ID

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

pac connector init `
  --connection-template "OAuthAAD" `
  --generate-script-file "contoso_script_file" `
  --generate-settings-file "contoso_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.

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

Groupes de commandes Microsoft Power Platform CLI
Microsoft Power PlatformVue d’ensemble d’un processus CLI