对 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版本兼容性矩阵，请参阅“先决条件”部分。

在更新的 CI/CD 代理上运行较旧的 CLI 版本

托管的 CI/CD 环境（例如 Azure DevOps、GitHub Actions 和 GitLab runs）会定期刷新其生成代理映像，并删除已达到使用寿命的较旧 .NET 运行时。

如果您的管道使用较旧的 CLI 版本，并且代理不再提供 CLI 版本对应的确切 .NET Runtime，则 CLI 可能无法启动，并显示如下错误：

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

这并不表示 UiPath CLI 存在产品问题，而是表示 CLI 内部版本与其运行环境之间运行时不匹配。

分辨率：

要恢复兼容性，请在uipcli.exe旁边的uipcli.runtimeconfig.json文件中添加前滚策略。这使 CLI 可以在比最初构建的 .NET 运行时更新的 .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> 替换为实际密码。此外，您还必须遵守下表中详述的转义规则：

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\`"。