Fehlerbehebung bei der UiPath-CLI

Wenn bei der Verwendung der UiPath-CLI Probleme auftreten, ziehen Sie die folgenden Problembehandlungsszenarien in Betracht.

Probleme im Zusammenhang mit der .NET -Version

Beschreibung:

Bei UiPath-CLI-Aufgaben und Pipelinevorgängen können Probleme auftreten, wenn die richtige Version des .NET -Frameworks nicht auf Ihrem System installiert ist (oder fehlt).

Wenn dieses Problem auftritt, können Fehlermeldungen auftreten wie:

• 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:

Sie müssen sicherstellen, dass Sie die richtige .NET -Version installiert haben.

Die Kompatibilitätsmatrix der CLI und der .NET -Version finden Sie im Abschnitt Voraussetzungen .

Ausführen älterer CLI-Versionen auf aktualisierten CI/CD-Agenten

Gehostete CI/CD-Umgebungen wie Azure DevOps, GitHub Actions und GitLab Runtimes aktualisieren ihre Build-Agent-Images regelmäßig und entfernen ältere .NET-Laufzeiten, die das Ende ihrer Lebensdauer erreicht haben.

Wenn Ihre Pipeline eine ältere CLI-Version verwendet und der Agent nicht mehr genau die .NET-Runtime bereitstellt, für die die CLI-Version erstellt wurde, startet die CLI möglicherweise nicht mit einem Fehler wie:

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

Dies weist nicht auf ein Produktproblem mit der UiPath-CLI hin, sondern auf eine Laufzeitabweichung zwischen dem CLI-Build und der Umgebung, in der er ausgeführt wird.

Lösung:

Um die Kompatibilität wiederherzustellen, fügen Sie eine Roll-Forge-Richtlinie in der Datei uipcli.runtimeconfig.json neben uipcli.exe hinzu. Dadurch kann die CLI in neueren .NET-Runtimes ausgeführt werden, als sie ursprünglich entwickelt wurde.

Suchen Sie die Zielframeworkversion, für die Ihre CLI erstellt wurde (überprüfen Sie die Fehlermeldung oder die vorhandene uipcli.runtimeconfig.json -Datei, falls vorhanden) und erstellen oder ändern Sie die Datei dann wie folgt:

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

Ersetzen Sie X.0 durch die Ziel-Framework-Version (z. B. net6.0, net8.0) und X.0.0 durch die Laufzeitversion (z. B. 6.0.0, 8.0.0).

Mit der Einstellung "rollForward": "LatestMajor" kann die CLI jede neuere .NET-Runtime verwenden, die auf dem Agent verfügbar ist.

Wenn Ihre Umgebung einen benutzerdefinierten .NET-Installationspfad verwendet, lesen Sie die obige Anleitung zum Konfigurieren von DOTNET_ROOT und Überprüfen des Laufzeitspeicherorts.

Probleme im Zusammenhang mit Sonderzeichen in Kennwörtern von Verbindungszeichenfolgen

In den meisten Fällen werden Verbindungskennwörter in einzelne Anführungszeichen (') eingeschlossen. Wenn das Kennwort jedoch Sonderzeichen wie ` oder $ enthält, ist ein anderer Ansatz erforderlich.

In diesen Fällen muss das Kennwort wie \`"<password>\`" formatiert werden, wobei <password> durch das tatsächliche Kennwort ersetzt wird. Zudem müssen Sie die Escape-Regeln der folgenden Tabelle einhalten:

Originalformat in ADUC	Escape-Format in PowerShell-Zeichenfolge
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$"

Beispiel:

Angenommen, das ursprüngliche Kennwort ist 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Gemäß Escape-Regeln für Sonderzeichen wird daraus: Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".