Probleme mit Microsoft Power Platform CLI beheben

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:

• Wann und wie der --log-to-console Parameter verwendet wird
• Beheben eines Fehlers, der besagt, dass die DotnetToolSettings.xml Datei fehlt

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 flüchtigen Läufern (z. B. GitHub-gehosteten Läufern) aus, bei denen die lokalen 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 Actions 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 }}

- task: PowerShell@2
  displayName: Import solution with PAC CLI diagnostics
  inputs:
    targetType: inline
    script: |
      pac --log-to-console solution import --path "$(Build.SourcesDirectory)\ContosoSolution.zip" --environment "$(EnvironmentUrl)"

Beheben von fehlendem DotnetToolSettings.xml

Wenn ein PAC CLI-Befehl mit einer fehlenden Meldung DotnetToolSettings.xml 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 Problem #38172 nachverfolgt.

Ursache

• PAC CLI 2.x und höhere Versionen werden mit .NET 10 erstellt und erfordern, dass .NET 10 als Voraussetzung installiert werden muss.
• PAC CLI 1.x-Versionen werden mit .NET 9 erstellt und erfordern, dass .NET 9 als Voraussetzung installiert werden muss.
• Wenn die erforderliche .NET Version nicht installiert ist, kann der Fehler als DotnetToolSettings.xml fehlen auftreten, anstelle einer klareren Fehlermeldung zur Laufzeit.
• 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 Laufzeit für diese PAC CLI-Hauptversion:

   • PAC CLI 2.x oder höher -> installieren Sie .NET 10
   • PAC CLI 1.x -> installiere .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

Übersicht über Microsoft Power Platform CLI
Power Platform CLI-Befehlsreferenz
Pac-Paketbefehlsreferenz