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 バージョンの相互運用性マトリクスについては、「 前提条件 」セクションをご覧ください。

Running older CLI versions on updated CI/CD agents

Hosted CI/CD environments such as Azure DevOps, GitHub Actions, and GitLab Runners periodically refresh their build agent images and remove older .NET runtimes that have reached end of life.

If your pipeline uses an older CLI version and the agent no longer provides the exact .NET runtime that CLI version was built for, the CLI may fail to start with an error such as:

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

This does not indicate a product issue with UiPath CLI but rather a runtime mismatch between the CLI build and the environment where it runs.

解決方法

To restore compatibility, add a roll-forward policy in the uipcli.runtimeconfig.json file located next to uipcli.exe. This allows the CLI to run on newer .NET runtimes than it was originally built for.

Locate the target framework version that your CLI was built for (check the error message or the existing uipcli.runtimeconfig.json file if present), then create or modify the file as follows:

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

Replace X.0 with the target framework version (e.g., net6.0, net8.0) and X.0.0 with the runtime version (e.g., 6.0.0, 8.0.0).

The "rollForward": "LatestMajor" setting allows the CLI to use any newer .NET runtime available on the agent.

If your environment uses a custom .NET installation path, refer to the guidance above on configuring DOTNET_ROOT and verifying the runtime location.

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

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

このような場合、パスワードは \`"<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\`" になります。