Partager via

Résoudre les problèmes liés à Microsoft Power Platform CLI

Découvrez certaines étapes que vous pouvez effectuer pour résoudre les problèmes si l’interface CLI Power Platform ne fonctionne pas correctement. Cet article contient des informations sur :

Utiliser le paramètre global --log-to-console

Le paramètre global --log-to-console envoie les journaux de diagnostic du PAC CLI à la sortie de la console, permettant ainsi aux journaux de pipeline de les capturer immédiatement.

pac --log-to-console <noun> <verb> [parameters]

Quand utiliser ce paramètre

Utilisez --log-to-console quand :

  • Vous exécutez PAC CLI sur des exécuteurs éphémères, comme ceux hébergés par GitHub, où les fichiers locaux sont supprimés lorsque le travail se termine.
  • Un pipeline échoue avant qu'une étape distincte de chargement de journaux puisse publier les journaux locaux du CLI PAC.
  • Vous avez besoin de diagnostics immédiats dans les journaux des travaux Azure DevOps ou GitHub Actions pour trier les déploiements ayant échoué.

--log-to-console est un paramètre d’interface CLI PAC globale. Cela signifie que vous pouvez l’utiliser avec n’importe quelle commande PAC CLI.

Exemples

- name: Import solution with PAC CLI diagnostics
  run: pac --log-to-console solution import --path ContosoSolution.zip --environment ${{ secrets.ENVIRONMENT_URL }}

Note

La pac package deploy commande dispose également de paramètres de journalisation spécifiques à la commande (--logConsole et --logFile) pour le résultat du déploiement du package.

Résoudre le problème d'absence de DotnetToolSettings.xml

Si une commande PAC CLI échoue avec un DotnetToolSettings.xml message manquant, la version .NET installée ne correspond généralement pas à la version principale de l’interface PAC CLI.

Ce comportement connu de l’outil .NET est suivi dans le problème dotnet/sdk #38172.

La cause

  • PAC CLI 2.x et versions ultérieures sont générées avec .NET 10 et nécessitent l’installation de .NET 10 en tant que prérequis.
  • Les versions pac CLI 1.x sont générées avec .NET 9 et nécessitent l’installation de .NET 9 comme condition préalable.
  • Si la version .NET requise n’est pas installée, l’erreur peut apparaître comme DotnetToolSettings.xml manquante au lieu d’un message d’exécution plus clair.
  • Même quand plusieurs kits SDK sont installés, une configuration locale global.json peut forcer dotnet à utiliser un SDK plus ancien qui ne peut pas exécuter l’outil.
  • Certains utilisateurs ont signalé ce problème avec des trains de correctifs sdk plus anciens. La mise à jour vers des correctifs sdk plus récents peut résoudre le problème.

Comment le corriger

Procédez comme suit pour corriger cette erreur.

  1. Vérifiez la version de l’interface CLI PAC :

    pac

  2. Installez le Kit de développement logiciel (SDK) ou le runtime .NET requis pour cette version principale de l’interface CLI PAC :

    • PAC CLI 2.x ou version ultérieure -> installer .NET 10
    • PAC CLI 1.x -> installez .NET 9

  3. Vérifiez que le Kit de développement logiciel (SDK) requis est disponible sur l’ordinateur ou l’agent de build :

    dotnet --list-sdks

  4. Vérifiez si dotnet est épinglé par global.json dans l’arborescence du répertoire courant :

    dotnet --info

    Si global.json pointe vers un SDK plus ancien, mettez-le à jour ou exécutez à partir d’un répertoire qui n’épingle pas un SDK incompatible.

  5. Réexécutez la commande PAC CLI.

Dans les systèmes CI (GitHub Actions et Azure DevOps), installez explicitement la version .NET requise dans le pipeline avant l’exécution de l’interface CLI PAC.

Si vous voyez cette erreur lors de l’installation d’un autre package (et non de l’interface CLI PAC), vérifiez que le package est un package d’outils .NET. Les packages NuGet non-outil peuvent produire des messages similaires avec dotnet tool install.

Voir aussi

Vue d'ensemble du Microsoft Power Platform CLI
Référence des commandes CLI de Power Platform
Informations de référence sur la commande pac package

  • Last updated on