Qu’est-ce que Microsoft Power Platform CLI ?

  • Article

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
  • Portails
  • Composants de code
  • et plus encore.

Microsoft Power Platform CLI est disponible pour une utilisation dans les régions du Cloud de la communauté du secteur public et GCC High (cloud souverain aux É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.

Installer Microsoft Power Platform CLI

Vous pouvez installer Microsoft Power Platform CLI en utilisant l’une ou les deux méthodes suivantes :

Méthode d’installation Description
Installer avec Power Platform Tools pour Visual Studio Code Permet l’utilisation de commandes dans un terminal PowerShell dans Visual Studio Code sur Windows 10, Windows 11, Linux et macOS.
Installer Power Platform CLI pour Windows Permet l’utilisation de commandes à l’aide de PowerShell pour Windows 10 et Windows 11.
Certaines commandes, telles que pac data, ne sont disponibles qu’en utilisant Power Platform CLI pour Windows

Installer avec Power Platform Tools pour Visual Studio Code

Suivez ces étapes pour installer Microsoft Power Platform CLI à l’aide de Visual Studio Code.

  1. Ouvrez Visual Studio Code.

  2. Sélectionnez l’icône Extensions dans le volet Activité. Dans la barre de recherche, saisissez Power Platform Tools.

  3. Sélectionnez Installer. Une fois l’installation terminée, redémarrez Visual Studio Code pour afficher l’extension dans la fenêtre Terminal.

    Installation de l’extension VS Code

    Note

    Extension Power Platform Tools pour que Visual Studio Code se mette à jour automatiquement.

  4. Vous pouvez éventuellement lancer l′installation dans Visual Studio Code directement depuis Marketplace qui lance Visual Studio Code et démarre l′installation de l′extension.

    Lancez l’installation depuis Marketplace

Vous pouvez également effectuer une installation à chargement latéral dans Visual Studio Code en téléchargeant l’extension depuis Marketplace.

Installation à chargement latéral de Power Platform Tools pour Visual Studio Code

Dans certaines organisations, le téléchargement ou le lancement d’une installation sur le Web est interdit. Dans la plupart des cas, l’organisation télécharge le support d’installation et le stocke dans un emplacement sécurisé et vérifie qu’il fonctionne conformément à ses normes, avant de le distribuer au sein de l’organisation. Utilisez les instructions suivantes pour prendre en charge ce type d’installation.

  1. Accédez à Marketplace et plutôt que d’appuyer sur le bouton Installer, sélectionnez le lien Télécharger l’extension sous Ressources.

    Télécharger l’extension

    Cliquez sur ce lien pour télécharger un fichier avec une extension .vsix sur votre poste de travail.

    Extension téléchargé

  2. Lancez Visual Studio Code et sélectionnez l’icône Extension, sélectionnez les points de suspension sur la barre latérale Extension, puis sélectionnez Installer à partir de VSIX.

    Installer depuis un fichier VSIX

Installation réussie

Une fois l’installation réussie, vous devez redémarrer Visual Studio Code pour voir la notification suivante.

Notification d’installation

Sur la barre Activité. vous remarquez l’icône de Power Platform Tools.

icône

La vérification finale serait de lancer la fenêtre du terminal et de taper pac.

PAC CLI dans la fenêtre du terminal

Désinstaller Power Platform Tools pour Visual Studio Code

Pour désinstaller Power Platform Tools pour Visual Studio Code, suivez les mêmes étapes que pour l’installation de l’extension, mais en sélectionnant le bouton Désinstaller.

Installer Power Platform CLI pour Windows

Pour installer Power Platform CLI pour Windows, vous pouvez le faire via l’outil DotNet ou .msi.

  • Pour l’installer via l’outil DotNet, .NET doit être installé (.NET 6.0 recommandé). Installez Power Platform CLI en utilisant cette commande :

    dotnet tool install --global Microsoft.PowerApps.CLI.Tool

  • Pour l’installer via .msi, téléchargez et exécutez le fichier .msi disponible ici : Microsoft Power Platform CLI, choisissez l’option Installer.

Mettre à jour Power Platform CLI pour Windows

Pour tirer parti de toutes les fonctionnalités les plus récentes, mettez à jour l’interface de ligne de commande Microsoft Power Platform avec la dernière version disponible via cette commande :

pac install latest

Note

La commande pac install latest n’est pas applicable pour Power Platform Tools pour Visual Studio Code. Elle recherchera des mises à jour et se mettra à jour automatiquement à chaque fois que vous ouvrirez Visual Studio Code.

Désinstaller Power Platform CLI pour Windows

Pour désinstaller Power Platform CLI pour Windows, télécharger et exécuter le fichier .msi disponible ici : Microsoft Power Platform CLI et choisissez l’option Supprimer.

Installer Power Platform CLI pour Linux/macOS

Pour installer Power Platform CLI pour Linux/macOS en utilisant l’outil DotNet, .NET doit être installé (.NET 6.0 recommandé). Installez Power Platform CLI en utilisant cette commande :

dotnet tool install --global Microsoft.PowerApps.CLI.Tool

L’emplacement par défaut des fichiers binaires d’un outil dépend du système d’exploitation :

Système d’exploitation Chemin d’accès
Linux/mac OS $HOME/.dotnet/tools
Fenêtres %USERPROFILE%\.dotnet\tools

Cet emplacement est ajouté au chemin d’accès de l’utilisateur lors de la première exécution du SDK. Ainsi, les outils globaux peuvent être invoqués à partir de n’importe quel répertoire sans spécifier l’emplacement de l’outil.

L’accès aux outils est spécifique à l’utilisateur et non global à la machine. Un outil global n’est disponible que pour l’utilisateur qui a installé l’outil.

Commandes courantes

Ce tableau répertorie certaines des commandes courantes utilisées dans la PAC CLI.

Command Description
pac admin Commandes pour les fonctionnalités du cycle de vie de l’environnement.
pac auth Commandes pour se connecter à votre environnement.
pac application Commandes pour installer les applications AppSource qui sont des prérequis au fonctionnement de la solution dans l’environnement cible (version préliminaire).
pac canvas Commandes pour travailler avec les fichiers source de l’application canevas (version préliminaire).
pac org Commandes à utiliser avec les environnements Dataverse.
pac package Commandes à utiliser avec les packages de solution.
pac paportal Commandes à utiliser avec les la prise en charge des portails dans Microsoft Power Platform CLI.
pac pcf Commandes pour utiliser Power Apps component framework.
pac plugin Commande pour créer un projet de plug-in.
pac solution Commandes pour utiliser les projets de solution Dataverse.
pac telemetry Gère les paramètres de télémétrie.

Pourboire

Pour obtenir la liste complète des commandes prises en charge, consultez Groupes de commandes Microsoft Power Platform CLI ou exécutez la commande pac ou pac<subcommand>, par exemple : pac solution.

Voir aussi

Groupes de commandes Microsoft Power Platform CLI
Power Apps component framework