Teilen über

Problembehandlung bei der Microsoft Power Platform CLI

Erfahren Sie mehr über einige Schritte, die Sie ausführen können, um Probleme zu beheben, wenn die Power Platform CLI nicht ordnungsgemäß funktioniert. Dieser Artikel enthält Informationen zu:

Verwenden des globalen --log-to-console Parameters

Der globale --log-to-console Parameter sendet PAC CLI-Diagnoseprotokolle an die Konsolenausgabe, sodass Pipelineprotokolle sie sofort erfassen.

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

Wann dieser Parameter verwendet werden soll

Verwenden Sie --log-to-console in folgenden Fällen:

  • Sie führen PAC CLI auf kurzlebigen Runnern (z. B. von GitHub gehosteten Runnern) aus, bei denen lokale Dateien verworfen werden, wenn der Auftrag endet.
  • Eine Pipeline schlägt fehl, bevor ein separater Protokolluploadschritt lokale PAC CLI-Protokolle veröffentlichen kann.
  • Sie benötigen eine sofortige Diagnose in Azure DevOps- oder GitHub-Aktions-Auftragsprotokollen, um fehlgeschlagene Bereitstellungen zu triagen.

--log-to-console ist ein globaler PAC CLI-Parameter. Dies bedeutet, dass Sie sie mit jedem PAC CLI-Befehl verwenden können.

Beispiele

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

Hinweis

Der pac package deploy Befehl verfügt außerdem über befehlsspezifische Protokollierungsparameter (--logConsole und --logFile) für die Paketbereitstellungsausgabe.

Beheben von fehlendem DotnetToolSettings.xml

Wenn ein PAC CLI-Befehl mit einer DotnetToolSettings.xml fehlenden Meldung fehlschlägt, stimmt die installierte .NET-Version in der Regel nicht mit der PAC CLI-Hauptversion überein.

Dieses bekannte .NET-Toolverhalten wird in dotnet/sdk Issue #38172 nachverfolgt.

Ursache

  • PAC CLI 2.x und höhere Versionen werden mit .NET 10 erstellt und erfordern die Installation von .NET 10 als Voraussetzung.
  • PAC CLI 1.x-Versionen werden mit .NET 9 erstellt und erfordern, dass .NET 9 als Voraussetzung installiert wird.
  • Wenn die erforderliche .NET-Version nicht installiert ist, kann der Fehler anstelle einer übersichtlicheren Laufzeitmeldung als DotnetToolSettings.xml fehlt angezeigt werden.
  • Selbst wenn mehrere SDKs installiert sind, kann ein lokales global.json Sdk die Verwendung eines älteren SDK erzwingen dotnet , das das Tool nicht ausführen kann.
  • Einige Benutzer haben dieses Problem mit älteren SDK-Patchzügen gemeldet. Das Problem kann durch das Aktualisieren auf neuere SDK-Patches behoben werden.

So beheben Sie es

Führen Sie die folgenden Schritte aus, um diesen Fehler zu beheben.

  1. Überprüfen Sie die PAC CLI-Version:

    pac

  2. Installieren Sie das erforderliche .NET SDK oder die Laufzeitumgebung für die Hauptversion der PAC CLI.

    • PAC CLI 2.x oder höher -> .NET 10 installieren
    • PAC CLI 1.x -> Installation von .NET 9

  3. Überprüfen Sie, ob das erforderliche SDK auf dem Computer oder Build-Agent verfügbar ist:

    dotnet --list-sdks

  4. Überprüfen Sie, ob dotnet in der aktuellen Verzeichnisstruktur von global.json angeheftet ist:

    dotnet --info

    Wenn global.json auf ein älteres SDK verweist, aktualisieren Sie es oder verwenden Sie ein Verzeichnis, das keine inkompatible SDK-Version festlegt.

  5. Führen Sie den PAC CLI-Befehl erneut aus.

Installieren Sie in CI-Systemen (GitHub Actions und Azure DevOps) explizit die erforderliche .NET-Version in der Pipeline, bevor PAC CLI ausgeführt wird.

Wenn dieser Fehler beim Installieren eines anderen Pakets (nicht PAC CLI) angezeigt wird, überprüfen Sie, ob es sich bei dem Paket um ein .NET-Toolpaket handelt. Nicht toolbasierte NuGet-Pakete können ähnliche Nachrichten mit dotnet tool install erzeugen.

Siehe auch

Microsoft Power Platform CLI – Übersicht
Power Platform CLI-Befehlsreferenz
Pac-Paketbefehlsreferenz

  • Last updated on