pac auth

Gérer la manière dont vous vous authentifiez auprès de divers services

Se connecter à votre client

Utilisez la commande pac auth create pour vous connecter à votre client. L’exécution de pac auth create crée un profil d’authentification sur votre ordinateur. Plusieurs profils d’authentification peuvent être disponibles. Avoir plusieurs profils d’authentification est intéressant lorsque vous travaillez avec plusieurs clients. Par exemple, lorsque votre entreprise utilise plusieurs clients (pour le développement, la production et les tests) ou lorsque vous êtes un consultant qui travaille pour plusieurs clients.

La commande pac auth create présente quelques paramètres utiles :

  • Le paramètre --environment vous permet de vous connecter automatiquement à l’environnement approprié. Si vous omettez le paramètre --environment, vous êtes connecté à l’environnement par défaut, mais avec le paramètre --environment ajouté, vous pouvez vous connecter à un autre environnement. Vous pouvez utiliser l’ID d’environnement, l’URL, le nom unique ou le nom partiel comme valeur.

  • Dans les environnements où vous n’avez pas la possibilité d’utiliser un expérience interactive, l’ajout du paramètre --deviceCode garantit que vous pouvez toujours vous connecter. Par exemple, dans GitHub Codespaces, le paramètre --deviceCode est automatiquement ajouté lorsque vous exécutez pac auth create.

Exemple

Pour vous connecter à l’environnement HR-Dev, vous pouvez utiliser l’exemple suivant :

pac auth create --environment "HR-Dev"

Passer à un autre profil d’authentification

Lorsque vous disposez de plusieurs profils d’authentification, vous pouvez facilement changer en utilisant les commandes pac auth list et pac auth select.

La commande pac auth list répertorie tous les profils d’authentification sur votre machine. La commande pac auth select sélectionne une commande différente.

Exemple de pac auth list

Pour répertorier tous les profils d’authentification, utilisez l’exemple suivant :

pac auth list

L’exécution de la commande pac auth list renvoie tous les profils d’authentification :

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

Sélectionnez un autre profil d’authentification en utilisant la valeur d’index.

pac auth select --index 2

Commandes

Commande Description
pac auth clear Effacer tous les profils d’authentification stockés sur cet ordinateur
pac auth create Créer et stocker des profils d’authentification sur cet ordinateur
pac auth delete Supprimer un profil d’authentification spécifique
pac auth list Répertorier les profils d’authentification stockés sur cet ordinateur
pac auth name Nommer ou renommer un profil d’authentification existant
pac auth select Sélectionner le profil d’authentification qui doit être actif
pac auth update Mettre à jour le nom ou l’environnement cible d’un profil d’authentification existant

pac auth clear

Effacer tous les profils d’authentification stockés sur cet ordinateur

pac auth create

Créer et stocker des profils d’authentification sur cet ordinateur

Examples

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

Création de base

Cet exemple vous demande vos informations d’identification et vous connecte au client auquel appartiennent les informations d’identification.

pac auth create

Note

Lors de l’exécution de Power Platform CLI dans Codespaces, cela déclenchera une connexion par code d’appareil.

Création d’un environnement

Cet exemple vous demande vos informations d’identification et vous connecte à l’environnement Power Platform avec l’ID d’environnement que vous spécifiez.

pac auth create --environment < Your environment ID >

Astuce

Pour trouver un ID d’environnement :

  1. Ouvrez le centre d’administration Power Platform et sélectionnez l’Environnement auquel vous souhaitez vous connecter. Dans la section Détails, recherchez ID d’environnement

Création nommée

Cet exemple s’authentifie avec votre client et lui donne le nom MyOrg.

pac auth create --name MyOrg

Création nommée par le principal de service

Cet exemple s’authentifie avec votre client, lui donne le nom MyOrg-SPN et utilise un principal de service pour le faire. N’oubliez pas d’ajouter le principal de service à votre environnement.

pac auth create --name MyOrg-SPN --applicationId 00000000-0000-0000-0000-000000000000 --clientSecret $clientSecret --tenant 00000000-0000-0000-0000-000000000000

Paramètres facultatifs pour auth create

--applicationId -id

Facultatif : ID d’application pour l’authentification.

--certificateDiskPath -cdp

Facultatif : chemin d’accès au disque du certificat pour l’authentification

--certificatePassword -cp

Facultatif : mot de passe du certificat pour l’authentification

--clientSecret -cs

Facultatif : clé secrète client pour l’authentification

--cloud -ci

Facultatif : instance cloud pour l’authentification

Utilisez l’une de ces valeurs :

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Utilise le flux du code d’appareil de l’ID Microsoft Entra pour la connexion interactive.

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

--environment -env

Environnement par défaut (ID, URL, nom unique ou nom partiel).

--kind -k

Obsolète : ce paramètre est ignoré.

--managedIdentity -mi

Utilisez une identité gérée Azure.

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

--name -n

Nom que vous voulez attribuer à ce profil d’authentification (30 caractères au maximum).

Remarque : la longueur du nom doit être comprise entre 1 et 30

--password -p

Facultatif : Le mot de passe d’authentification

--tenant -t

ID client si l’ID application/la clé secrète client ou l’ID application/le certificat client est utilisé.

--url -u

Déconseillé : Utilisez plutôt --environment.

--username -un

Facultatif : Le nom d’utilisateur d’authentification ; affiche la boîte de dialogue ID Microsoft Entra si elle n’est pas spécifiée.

Remarques

Pour le paramètre cloud, les valeurs à utiliser sont mappées à ces autres acronymes ou noms courants :

  • GCC = UsGov
  • GCC High = UsGovHigh
  • DoD = UsGovDod

pac auth delete

Supprimer un profil d’authentification spécifique

Exemple

pac auth delete --index 2

Paramètres facultatifs pour auth delete

--index -i

Index du profil à supprimer

Remarque : la valeur doit être un entier avec une valeur minimale de 1.

--name -n

Nom du profil à activer

Remarque : la longueur du nom doit être comprise entre 1 et 30

pac auth list

Répertorier les profils d’authentification stockés sur cet ordinateur

pac auth name

Nommer ou renommer un profil d’authentification existant

Exemple

L’exemple suivant montre comment renommer un profil d’authentification. Dans ce cas, le profil avec l’index 1 sera renommé « Contoso Dev ».

pac auth name --index 1 --name "Contoso Dev"

Paramètres obligatoires pour auth name

--index -i

Index du profil à nommer/renommer

Remarque : la valeur doit être un entier avec une valeur minimale de 1.

--name -n

Nom que vous voulez attribuer à ce profil d’authentification (30 caractères au maximum).

Remarque : la longueur du nom doit être comprise entre 1 et 30

pac auth select

Sélectionner le profil d’authentification qui doit être actif

Exemple

pac auth select --index 2

Paramètres facultatifs pour auth select

--index -i

Index du profil à activer.

Remarque : la valeur doit être un entier avec une valeur minimale de 1.

--name -n

Nom du profil à activer

Remarque : la longueur du nom doit être comprise entre 1 et 30

pac auth update

Mettre à jour le nom ou l’environnement cible d’un profil d’authentification existant

Examples

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

Mettre à jour le profil d’authentification avec l’URL de l’environnement

Cet exemple montre comment mettre à jour le profil d’authentification ayant l’index 1 avec le nom Contoso Dev et l’URL de l’environnement https://contosodev.crm.dynamics.com.

pac auth update --index 1 --name "Contoso Dev" --environment "https://contosodev.crm.dynamics.com"

Mettre à jour le profil d’authentification avec l’ID de l’environnement

Cet exemple montre comment mettre à jour le profil d’authentification ayant l’index 1 avec l’ID de l’environnement 00000000-0000-0000-0000-000000000000.

pac auth update --index 1 --environment 00000000-0000-0000-0000-000000000000

Paramètres obligatoires pour auth update

--index -i

Index du profil à nommer/renommer

Remarque : la valeur doit être un entier avec une valeur minimale de 1.

Paramètres facultatifs pour auth update

--environment -env

Environnement par défaut (ID, URL, nom unique ou nom partiel).

--name -n

Nom que vous voulez attribuer à ce profil d’authentification (30 caractères au maximum).

Voir aussi

Groupes de commandes Microsoft Power Platform CLI
Vue d’ensemble de Microsoft Power Platform CLI