次の方法で共有

Microsoft Power Platform CLI のトラブルシューティング

Power Platform CLI が正常に動作しない場合に問題をトラブルシューティングするために実行できるいくつかの手順について説明します。 この記事には、次に関する情報が含まれています。

グローバル --log-to-console パラメーターを使用する

グローバル --log-to-console パラメーターは、PAC CLI 診断ログをコンソール出力に送信して、パイプライン ログですぐにキャプチャできるようにします。

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

このパラメーターを使用する場合

次のようなときは --log-to-console を使います。

  • PAC CLI は、ジョブの終了時にローカル ファイルが破棄されるエフェメラル ランナー (GitHub でホストされるランナーなど) で実行しています。
  • 別のログ アップロード 手順でローカル PAC CLI ログを発行する前に、パイプラインが失敗します。
  • 失敗したデプロイをトリアージするには、Azure DevOps または GitHub Actions ジョブ ログで即時診断が必要です。

--log-to-console はグローバル PAC CLI パラメーターです。 つまり、任意の PAC CLI コマンドで使用できます。

例示

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

注

pac package deploy コマンドには、パッケージ展開出力用のコマンド固有のログ パラメーター (--logConsoleと--logFile) もあります。

不足している DotnetToolSettings.xml を解決する

PAC CLI コマンドが失敗し、 DotnetToolSettings.xml メッセージが表示されない場合、インストールされている .NET バージョンは通常、PAC CLI のメジャー バージョンと一致しません。

この既知の .NET ツールの動作は 、dotnet/sdk の問題 #38172 で追跡されます。

原因

  • PAC CLI 2.x 以降のバージョンは .NET 10 で構築されており、前提条件として .NET 10 をインストールする必要があります。
  • PAC CLI 1.x バージョンは .NET 9 で構築されており、前提条件として .NET 9 をインストールする必要があります。
  • 必要な .NET バージョンがインストールされていない場合、エラーは、より明確なランタイムメッセージではなく、DotnetToolSettings.xml が不足しているように表示されることがあります。
  • 複数の SDK がインストールされている場合でも、ローカル global.json では、ツールを実行できない古い SDK を dotnet に強制的に使用させることができます。
  • 一部のユーザーは、古い SDK パッチ 列車でこの問題を報告しました。 新しい SDK パッチに更新すると、問題が解決する可能性があります。

解決方法

このエラーを修正するには、次の手順を使用します。

  1. PAC CLI のバージョンを確認します。

    pac

  2. その PAC CLI メジャー バージョンに必要な .NET SDK またはランタイムをインストールします。

    • PAC CLI 2.x 以降 -> .NET 10 のインストール
    • PAC CLI 1.x -> .NET 9 のインストール

  3. 必要な SDK がマシンまたはビルド エージェントで使用可能であることを確認します。

    dotnet --list-sdks

  4. dotnetが現在のディレクトリ ツリーのglobal.jsonによってピン留めされているかどうかを確認します。

    dotnet --info

    global.jsonが古い SDK を指している場合は、それを更新するか、互換性のない SDK をピン留めしないディレクトリから実行します。

  5. PAC CLI コマンドをもう一度実行します。

CI システム (GitHub Actions と Azure DevOps) では、PAC CLI を実行する前に、必要な .NET バージョンをパイプラインに明示的にインストールします。

(PAC CLI ではなく) 別のパッケージのインストール中にこのエラーが発生した場合は、パッケージが .NET ツール パッケージであることを確認します。 ツール以外の NuGet パッケージでは、 dotnet tool installを使用して同様のメッセージを生成できます。

こちらも参照ください

Microsoft Power Platform CLIの概要
Power Platform CLI コマンド リファレンス
pac package コマンド リファレンス

  • Last updated on