Qu’est-ce que Microsoft Power Platform CLI ?

Microsoft Power Platform CLI est une CLI pour développeurs simple et unique qui permet aux développeurs et aux éditeurs de logiciels indépendants d’effectuer diverses opérations dans Microsoft Power Platform liées à :

• Cycle de vie de l’environnement
• Authentification
• Environnements Microsoft Dataverse
• Packages de solution
• Power Pages
• Composants du code
• et plus...

Fournir des commentaires

Utilisez github.com/microsoft/powerplatform-build-tools/discussions pour afficher et envoyer des commentaires sur PAC CLI.

Installer Microsoft Power Platform CLI

Il existe trois méthodes pour installer Power Platform CLI. Vous pouvez utiliser plusieurs méthodes d’installation sur le même ordinateur.

Méthode	Prise en charge du système d’exploitation	Description
Installer l’extension Visual Studio Code	Windows, Linux, macOS	Permet l’utilisation de commandes dans un terminal PowerShell dans Visual Studio Code sur Windows 10, Windows 11, Linux et macOS. Lorsque vous effectuez l’installation en utilisant UNIQUEMENT cette méthode, PAC CLI ne sera disponible par défaut que dans un terminal Visual Studio Code, sauf si vous activez PAC CLI dans l’invite de commande (CMD) et les terminaux PowerShell pour Windows
Installer avec l’outil .NET	Windows, Linux, macOS	Permet l’utilisation de commandes dans un shell PowerShell, CMD ou Bash sur Windows 10, Windows 11, Linux et macOS. Cette méthode d’installation ne permet pas l’utilisation des commandes pac data ou de certaines commandes pac package (déployer et afficher) qui ne sont disponibles que pour Windows.
Installer avec Windows MSI	Windows uniquement	Permet l’utilisation de commandes dans un terminal PowerShell dans Visual Studio Code sur Windows uniquement. Vous pouvez gérer les versions installées avec cette méthode d’installation.

Note

Les commandes suivantes sont disponibles uniquement dans Windows :

• données pac
• déploiement du package pac
• spectacle de paquet pac

Pour utiliser ces commandes dans Windows, installez Power Platform CLI en utilisant l’une (ou les deux) de ces méthodes d’installation :

• Visual Studio Extension de code
• Windows MSI

Ces commandes ne sont pas disponibles dans Windows si vous effectuez l’installation uniquement à l’aide de l’outil .NET.

Vérifier si Power Platform CLI est déjà installé

Comment déterminer si Power Platform CLI est installé dépend de votre système d’exploitation.

Fenêtres

1. Ouvrez un terminal PowerShell :

   • Si vous avez UNIQUEMENT installé l’Extension Visual Studio Code, ouvrez une fenêtre du terminal PowerShell de Visual Studio Code.
   • Si vous avez effectué l’installation en utilisant l’outil .NET, ouvrez un terminal PowerShell de Visual Studio Code OU un terminal PowerShell.

2. Saisissez Get-Command pac | Format-List à l’invite et appuyez sur Entrée.

Les résultats devraient ressembler à ce qui suit :

Name            : pac.exe
CommandType     : Application
Definition      : C:\Users\you\.dotnet\tools\pac.exe
Extension       : .exe
Path            : C:\Users\you\.dotnet\tools\pac.exe
FileVersionInfo : File:             C:\Users\you\.dotnet\tools\pac.exe
                  InternalName:     pac.dll
                  OriginalFilename: pac.dll
                  FileVersion:      1.29.11
                  FileDescription:  Microsoft Power Platform CLI
                  Product:          Microsoft Power Platform©
                  ProductVersion:   1.29.11+g9e2b163
                  Debug:            False
                  Patched:          False
                  PreRelease:       False
                  PrivateBuild:     False
                  SpecialBuild:     False
                  Language:         Language Neutral

Lorsque Power Platform CLI n’est pas installé, vous recevrez cette erreur :

Get-Command: The term 'pac' is not recognized as a name of a cmdlet, function, script file, or executable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

Linux/macOS

Pour voir si Power Platform CLI est installé dans Linux ou macOS, ouvrez le terminal ou l’invite de commande, saisissez which pac à l’invite et appuyez sur Entrée.

Les résultats devraient ressembler à ce qui suit :

/home/you/.dotnet/tools/pac

Vérifier quelle version de Power Platform CLI est installée

Ouvrez l’invite de commande (sur Microsoft Windows) ou une session du terminal (dans Linux), saisissez pac et appuyez sur Entrée.

Vous devriez voir la syntaxe suivante, où la version se trouve sur la deuxième ligne.

Microsoft PowerPlatform CLI
Version: 1.30.3+g0f0e0b9

Gérer les profils d’authentification

La plupart des commandes PAC CLI nécessitent un accès authentifié aux ressources. Vous devrez créer et utiliser des profils d’authentification.

Note

Avec l’extension Visual Studio Code, vous pouvez afficher et gérer les profils d’authentification.

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 changer facilement 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.

pac auth list Exemple

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

Activer la saisie semi-automatique via la touche Tab dans PowerShell

Power Platform CLI a une commande pac complete similaire à la commande complete de .NET CLI.

Lorsque cette option est configurée en utilisant les instructions ci-dessous, vous pouvez saisir seulement le début d’une commande, puis utiliser la touche Tab pour terminer l’entrée saisie.

Pour ajouter la saisie semi-automatique via la touche Tab à PowerShell pour PAC CLI, créez ou modifiez le profil stocké dans la variable $PROFILE. Pour plus d’informations, voir Comment créer votre profil et Profils et stratégie d’exécution.

Ajoutez le code suivant à votre profil :

$scriptblock = {
    param($wordToComplete, $commandAst, $cursorPosition)

    &pac complete -s "$($commandAst.ToString())" | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
    }
}

Register-ArgumentCompleter -Native -CommandName pac -ScriptBlock $scriptblock

Autres shells

Vous pouvez également l’utiliser avec bash, zsh, fish et nushell. Au lieu de dotnet complete, utilisez pac complete

Disponibilité du cloud souverain des États-Unis

Microsoft Power Platform CLI est disponible pour une utilisation dans les régions GCC et GCC High (cloud souverain des États-Unis). Voir le paramètre --cloud pour la commande pac auth create pour en savoir plus sur les environnements cloud souverain des États-Unis pris en charge.

Étapes suivantes

Obtenez plus d’informations sur les commandes. Pour obtenir la liste complète des commandes prises en charge, exécutez la commande pac help ou pac <subcommand> help ; par exemple : pac solution help.

Ou bien, consultez la liste des commandes dans la documentation :

Microsoft Power Platform Groupes de commandes CLI

Voir aussi

Microsoft Power Platform Notes de version de la CLI
Microsoft Power Platform Groupes de commandes CLI
Power Apps Cadre de composants