UiPath CLI のトラブルシューティング

UiPath CLI の使用中に問題が発生した場合は、以下のトラブルシューティングをお試しください。

.NET のバージョンに関する問題

説明:

システムに正しいバージョンの .NET Framework がインストールされていない (または存在しない) 場合、UiPath CLI のタスクやパイプライン操作で問題が発生する可能性があります。

この問題が発生すると、次のようなエラー メッセージが表示されることがあります。

• You must install or update .NET to run this application.App: C:\Program Files (x86)\UiPath CLI\UiPath.CLI.Windows.23.10.8894.39673\tools\uipcli.exeArchitecture: x64Framework: 'Microsoft.NETCore.App', version '6.0.0' (x64).NET location: C:\Program Files\dotnetThe following frameworks were found:8.0.5 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]8.0.8 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]

• An error occurred trying to start process 'dotnet' with working directory 'C:\Users\Public\UiPathDevOpsScripts\uipathcli-23.10\tools'. The system cannot find the file specified. Failed to run the command. UiPath.CommandLine.Exceptions.CommandException: Packaging failed due to one or more errors.Message: An error occurred trying to start process 'dotnet' with working directory 'C:\Users\Public\UiPathDevOpsScripts\uipathcli-23.10\tools'. The system cannot find the file specified.Error at: System.Diagnostics.Process.StartWithCreateProcess(ProcessStartInfo startInfo)

解決策:

正しいバージョンの .NET がインストールされていることを確認する必要があります。

CLI と .NET バージョンの相互運用性マトリクスについては、「 前提条件 」セクションをご覧ください。

更新された CI/CD エージェントで古いバージョンの CLI を実行する

Azure DevOps、GitHub Actions、GitLab Runners などのホストされた CI/CD 環境では、ビルド エージェント イメージを定期的に更新し、サポートが終了した古い .NET ランタイムを削除します。

パイプラインで古いバージョンの CLI が使用されていて、その CLI バージョンが構築された正確な .NET ランタイムがエージェントによって提供されなくなった場合、CLI が次のようなエラーで開始に失敗することがあります。

The framework 'Microsoft.NETCore.App', version 'X.0.0' was not found.

これは、UiPath CLI の製品の問題ではなく、CLI のビルドとそれが実行される環境との間のランタイムの不一致を示しています。

解決方法

互換性を復元するには、uipcli.exeの横にある uipcli.runtimeconfig.json ファイルにロールフォワード ポリシーを追加します。これにより、CLI は、最初に構築されたときよりも新しい .NET ランタイムで実行できます。

CLI が構築されたターゲット フレームワークのバージョンを見つけて (エラー メッセージ、または既存の uipcli.runtimeconfig.json ファイルが存在する場合を確認してください)、次のようにファイルを作成または変更します。

{  "runtimeOptions": {    "tfm": "netX.0",    "framework": {      "name": "Microsoft.NETCore.App",      "version": "X.0.0",      "rollForward": "LatestMajor"    }  }}

X.0 をターゲット フレームワークのバージョン (例: net6.0、net8.0) に、X.0.0 を実行時のバージョン (例: 6.0.0、8.0.0) に置き換えます。

"rollForward": "LatestMajor"設定により、CLI はエージェントで使用可能な新しい .NET ランタイムを使用できます。

お使いの環境でカスタム .NET インストール パスを使用している場合は、上記の DOTNET_ROOT の構成とランタイムの場所の確認に関するガイダンスをご覧ください。

接続文字列パスワードの特殊文字に関する問題

ほとんどの場合、接続パスワードは単一引用符 (') で囲みます。ただし、パスワードに ` や $などの特殊文字が含まれている場合は、別の方法が必要です。

このような場合、パスワードは \`"<password>\`" とフォーマットする必要があります。ここで、<password> は実際のパスワードに置き換えてください。さらに、次の表に示すエスケープ ルールにも従う必要があります。

ADUC の元の形式	PowerShell のエスケープした文字列の形式
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

例：

元のパスワードが 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I であるとします。特殊文字のエスケープ ルール規則に従うと、Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`" になります。