对 UiPath CLI 进行故障排除

如果您在使用 UiPath CLI 时遇到问题，请考虑以下故障排除方案。

与.NET版本相关的问题

说明:

如果系统上未安装（或缺少）.NET 框架的正确版本，您可能会遇到 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)

Remedy:

必须确保安装正确的 .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> 替换为实际密码。此外，您还必须遵守下表中详述的转义规则：

ADDU 中的原始格式	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\`"。