Qu’est-ce que Microsoft Power Platform CLI ?

Microsoft Power Platform CLI est une CLI de développeur simple et unique qui permet aux développeurs et aux éditeurs de logiciels indépendants (ISV) 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 de 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.

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.

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

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.

/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 devez créer et utiliser des 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 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.

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 complète de .NET CLI.

Lorsqu’il est configuré à l’aide des instructions suivantes, vous pouvez taper uniquement le début d’une commande, puis utiliser la touche Tabulation pour terminer la 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 utiliser la complétion automatique 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 US Sovereign). 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 :

Voir aussi

Notes de publication Microsoft Power Platform CLI
Groupes de commandes Microsoft Power Platform CLI
Infrastructure de composants Power Apps