Migrationsübersicht

Migrationsübersicht für Teams, die von der älteren.NET-CLI zur UiPath CLI wechseln, mit Links zur Befehlsübersicht, Flag-Umbenennungen, grundlegenden Änderungen und Pipeline-Beispielen.

Der Abschnitt Migration ist für Teams gedacht, die von der Legacy-Version .NET CLI (uipcli.exe / dotnet uipcli.dll, mit Kalenderversion 2025.10 und früher) zu UiPath CLI 1.x (uip, TypeScript auf npm) wechseln. Die beiden CLIs sind verschiedene Binärdateien mit unterschiedlichen Befehlsstrukturen, Authentifizierungsmodellen und Ausgabeformaten – in diesem Abschnitt finden Sie die Zuordnung.

Wenn Sie mit 1.x neu beginnen und keine Legacy-Pipelines zu migrieren haben, überspringen Sie diesen Abschnitt und wechseln Sie direkt zu Erste Schritte und Anleitungen.

Die vier Seiten

Seite (Page)	Was damit abgedeckt wird	Lesen Sie es, wenn
Migrieren von der Legacy-.NET-CLI	Der Überblick: Was sich geändert hat und warum. Header für Unterschiede in der Laufzeit, Verteilung, Scope und Ausgabe.	Zuerst lesen – Legt den Kontext für die anderen drei fest.
Befehlszuordnung	Zuordnung pro Verb (uipcli package pack → uip rpa pack usw.) mit Klassifizierung (1:1, 2 Schritte, entfernt). Vorher/Nachher-Snippets.	Wenn Sie einen bestimmten uipcli -Aufruf portieren.
Umbenennungen kennzeichnen	Pro-Flag-Zuordnung innerhalb jedes Verbs (--governanceFilePath → --governance-file-path, -A/--accountForApp → --organization usw.).	Wenn Sie ein Verb zugeordnet haben, aber ein Flag fehlt oder umbenannt wurde.
Durchschlagende Änderungen	Semantische Verschiebungen, die sich auf jeden Befehl auswirken: Authentifizierungsmodi entfernt, implizites env-var-Lesen entfernt, Exit-Code-Vertrag, Standardformat.	Vor jeder Portierung – diese gelten auf jeden Fall.

Empfohlene Migrationsreihenfolge

Für eine typische CI-Pipelinemigration:

1. Migrieren von der Legacy-.NET-CLI → Laufzeit- und Verteilungsänderung (.NET → Node/Bun, MyGet → npm).
2. Durchschlagende Änderungen → Bevor Sie eine einzelne Zeile ändern, sollten Sie sich über die übergeordneten Unterschiede informieren. Allein die Authentifizierung kann Ihre Pipeline unterbrechen.
3. Befehlszuordnung → Gehen Sie Ihre vorhandenen uipcli -Aufrufe nacheinander durch. Beachten Sie die mit 2 Schritten oder N Schritten markierten Zeilen – sie benötigen eine neue Shell-Logik, keine einfache Umbenennung.
4. Flag-Umbenennungen → Details pro Flag ausfüllen.
5. Dann ein CI/CD-Release für Ihre Plattform – kopieren und anpassen.

Schnellstart für Ungeduldige

Der minimal mögliche Port:

# Legacy
uipcli package pack <project> -o <out>
uipcli package deploy <pkg> <url> <tenant> -A <org> -I <id> -S <secret> --processName <name>

# New (uip)
uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant <tenant>
uip rpa pack <project>
uip or packages upload <pkg>
uip or processes create --name <name> --package-key <key> --package-version <v> --folder-path Shared

Vollständige Details pro Flag finden Sie unter Flag-Umbenennungen.

Was nicht in der Migrationenthalten ist

• Neue Funktionen in 1.x , die keine Legacy-Äquivalente haben (Fähigkeiten, MCP, Sitzungen, JMESPath-Filterung). Diese live in Was gibt es Neues.
• Die Dokumentation der Legacy-CLI. Es befindet sich immer noch in den CI/CD-Integrationsdokumenten, die für 2025.10 und früher kanonisch bleiben.

Siehe auch

• Neuigkeiten – Überschriftszusammenfassung, Zielgruppe: alle, die sich entscheiden, ob sie migrieren möchten.
• Versionierung und Stabilität – der Vertrag, auf den Sie sich nach der Migration verlassen können.
• Authentifizierung – Der Authentifizierungsfluss wird von Ihrer Pipeline nach der Migration verwendet.