Migration: Befehlszuordnung

Jedes Legacy-Verb uipcli mit seinem Äquivalent uip . Legacy-Einträge spiegeln die öffentliche uipcli -Oberfläche wider, die für 2025.10 und früher dokumentiert wurde; Die Spalte uip entspricht den veröffentlichten Referenzseiten.

So können Sie diese Seite lesen. Zeilen werden nach Legacy-Verbfamilie (package, job, test, asset, solution, run) gruppiert. Jede Zeile hat eine Klassifizierung:

• 1:1 – direkte Umbenennung; Der neue Flag-Set ist nahe genug, dass ein technischer Port funktioniert.
• 2 Schritte / N Schritte – Ein Legacy-Verb ist mehreren uip -Aufrufen zugeordnet.
• Entfernt – Ersatz: … – Das Legacy-Verb hat keinen direkten Nachfolger; In der Spalte „Ersatz“ finden Sie den neuen Flow für das gleiche Ergebnis.

Weitere Informationen auf Flag-Ebene innerhalb jedes Verbs finden Sie unter Flag-Umbenennungen. Informationen zu den zugrunde liegenden Authentifizierungs-/Ausgabeänderungen, die für jedes Verb gelten, finden Sie unter Durchschlagende Änderungen.

Paket

Legacy-Befehl	uip gleichwertig ist	Hinweise
uipcli package pack <project>	uip rpa pack <project>	1:1. Die neue Flag-Oberfläche verwendet „kebab-case“; --outputType → --output-type, --autoVersion → --auto-version usw. uip rpa -Befehle rufen den Studio-Paketer auf, der.NET-unterstützt ist – der Ausführungsprogramm benötigt noch eine.NET-Laufzeit verfügbar. Siehe UIP-RPA-Paket.
uipcli package analyze <project>	uip rpa analyze <project> --governance-file-path <policy>	1:1. --governanceFilePath wird --governance-file-path (ke andere-Case). Die Regeln für die Workflow-Analyse sind unverändert. Es gilt das.NET-Backend, das gleiche wie rpa pack. Siehe UIP-RPA-Analyse.
uipcli package deploy <path> <url> <tenant>	uip or packages upload <path> Then uip or processes create --name <n> --package-key <k> --package-version <v> --folder-path <path>	2 Schritte. Die Legacy-Bereitstellung lädt die .nupkg hoch und erstellt einen Prozess in einem Aufruf; Die neue CLI löst diese Bedenken aus. Siehe UIP- oder Paketupload und UIP oder Prozesserstellung.
uipcli package restore <project>	uip rpa restore <project> [outputPath]	1:1. Stellt NuGet-Paketabhängigkeiten wieder her; unterstützt Air-Gap- und benutzerdefinierte NuGet-Konfigurationen über dieselben Flags wie Legacy. Das.NET-Backend gilt. Siehe UIP-RPA-Wiederherstellung.

Paket packen

# Legacy
uipcli package pack "C:\proj\project.json" -o "C:\dist" \
    --outputType Process --autoVersion \
    --traceLevel Information

# uip
uip rpa pack ./proj --output-type Process --auto-version

Die vollständige Flag-Liste finden Sie unter UIP-RPA-Paket . Das Tool umschließt denselben Studio-Paketer, den die Legacy-CLI verwendet, sodass Ausgabeformat und Projektunterstützung identisch sind.

Paketanalyse

# Legacy
uipcli package analyze "C:\proj\project.json" \
    --governanceFilePath "C:\policy.json" \
    --resultPath "C:\result.json" \
    --stopOnRuleViolation

# uip
uip rpa analyze ./proj \
    --governance-file-path ./policy.json \
    --result-path ./result.json \
    --stop-on-rule-violation

Paketbereitstellung

Dies ist die Zeile, die jeden Pipelineport abfasst. Legacy deploy ist ein einmaliges Hochladen und Erstellen; uip teilt es in zwei explizite Schritte auf, sodass das Paket einmal hochgeladen und an mehrere Ordner gebunden werden kann.

# Legacy — upload and create a process in one call
uipcli package deploy "C:\pkg\InvoiceProcessing.1.0.3.nupkg" \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders OR.Execution" \
    -o "Shared" \
    --processName "InvoiceProcessing" \
    --entryPointsPath "Main.xaml"

# uip — upload, then create the process
uip login \
  --client-id env.UIPATH_CLIENT_ID \
  --client-secret env.UIPATH_CLIENT_SECRET \
  --tenant TenantName

uip or packages upload ./InvoiceProcessing.1.0.3.nupkg
#    response includes "body": "InvoiceProcessing:1.0.3"

uip or processes create \
    --name InvoiceProcessing \
    --package-key InvoiceProcessing \
    --package-version 1.0.3 \
    --folder-path Shared \
    --entry-point Main.xaml

Hinweise:

• Die Positional <orchestrator_url> und <orchestrator_tenant> aus Legacy werden durch Sitzungskontext aus uip login ersetzt (plus optionale -t, --tenant -Überschreibung bei jedem Aufruf). Sie werden nie als Positionsargumente in uip angezeigt.
• Legacy --processName ist ein benutzerdefinierter Anzeigename für den erstellten Prozess. In uip ist das Äquivalent --name auf processes create – nicht --process (was nicht vorhanden ist).
• Legacy --processNames <csv> (Massenerstellung mit mehreren Prozessen in 25.10) hat kein direktes Äquivalent; Skripten Sie eine Schleife über Zeilen, oder lesen Sie Lösungen für den empfohlenen Multiprozess-Flow.
• Legacy --entryPointsPath (CSV) wird auf --entry-point (Einzelpfad) uip or processes create; Führen Sie processes create einmal pro Einstiegspunkt für Pakete mit mehreren Einstiegspunkten aus.

Paketwiederherstellung

# Legacy
uipcli package restore "C:\proj" \
    --restoreFolder "C:\deps" \
    --nugetConfigFilePath "C:\NuGet.Config"

# uip
uip rpa restore ./proj ./deps

Auftrag

Legacy-Befehl	uip gleichwertig ist	Hinweise
uipcli job run <processName> <url> <tenant>	uip or jobs start <process-key>	1:1 bei Absicht; Identität ist eine GUID, kein Name. Die Legacy-CLI verwendete den Namen der Prozessversion als Positionsargument; Die neue CLI verwendet den Prozessschlüssel (GUID), der von uip or processes list zurückgegeben wird. Verwenden Sie --wait-for-completion für das Legacy-Verhalten von -w true + -W <timeout> . Siehe UIP oder Auftragsstart.

# Legacy
uipcli job run "InvoiceProcessing" \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders OR.Execution OR.Jobs" \
    -o "Shared" \
    -i "C:\input.json" \
    -w true -W 3600

# uip — resolve the name to a key, then start with wait-for-completion
PROCESS_KEY=$(uip or processes list --folder-path Shared \
    --name InvoiceProcessing \
    --output-filter "Data[0].Key" \
    --output plain)

uip or jobs start "$PROCESS_KEY" \
    --input-file ./input.json \
    --wait-for-completion \
    --timeout 3600

Details auf Flag-Ebene:

• Legacy -i, --input_path <file> → uip bietet zwei Alternativen: --input-arguments '<json>' für Inline-JSON oder --input-file <path> für eine Dateinutzlast. Sie schließen sich gegenseitig aus.
• Legacy -j, --jobscount <n> → --jobs-count <n>.
• Legacy -P, --priority <Low|Normal|High> → --job-priority <Low|Normal|High>.
• Legacy -r, --robots <csv> → kein direktes Äquivalent (Konzept nur klassischer Ordner im Legacy). Zielmaschinen mit --machine-keys <csv> (GUIDs) oder Benutzer mit --user-keys <csv> (GUIDs).
• Legacy -f, --fail_when_job_fails (Standard: true) → die neue CLI beendet immer 1 wenn ein gewarteter Auftrag Faulted endet; Es gibt keine Opt-out-Option.
• Legacy -R, --result_path <file> → die neue CLI gibt den Auftragsumschlag in der Standardausgabe aus; mit > result.json umleiten oder --output-filter verwenden, um bestimmte Felder zu extrahieren.
• Legacy -b, --job_type <Unattended|NonProduction> → --runtime-type <Unattended|Headless|Serverless|NonProduction|Development|TestAutomation>.

test

Legacy-Befehl	uip gleichwertig ist	Hinweise
uipcli test run <url> <tenant> -s <testset>	uip tm testsets run --test-set-key <key> Then uip tm wait --execution-id <id> Then uip tm report get --execution-id <id>	3 Schritte (Starten → Warten → Überprüfen). Die neue CLI trennt „Fire the run“ von „block on it“ von „read the verdict“, sodass CI-Skripte bei jedem Zugriff sauber verzweigt werden können. Siehe Ausführung von UIP-TM-Testsets. Das neue Verb verbleibt auf der testsets -Ressource als uip tm testsets run – nicht auf der executions -Ressource (es gibt keine uip tm executions run).
uipcli test run <url> <tenant> -P <project.json> (Ein Projekt packen und testen)	uip rpa pack → uip or packages upload → Testsatz im Test Manager erstellen → uip tm testsets run	N Schritte. Der veraltete One-Shot-Flow „Dieses Projekt packen, bereitstellen, seine Tests ausführen“ ist auf die Tools rpa, or und tm aufgeteilt. Das Erstellen des Testsatzes ist in der Regel eine einmalige Einrichtung, die auf der Web-UI des Test Managers durchgeführt wird.
uipcli test parallel <url> <tenant> --testsConfigurationFilePath <file>	Kein direktes Äquivalent – Schleife über uip tm testsets run -Aufrufe	Entfernt – Ersatz: Skripten Sie einen parallelen Start unabhängiger Testsätze mit uip tm testsets run (jeder gibt ein ExecutionId zurück), dann ein einzelnes uip tm wait pro Ausführung. Der Testprojekttreiber des Legacy-Verbs parallel (der intern uipcli test run aufgerufen hat) hat kein Gegenstück; Das neue Modell geht davon aus, dass Testsätze bereits im Test Manager autorisiert wurden.

Testausführung (Einzelner Testsatz)

# Legacy
uipcli test run \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders OR.TestSets OR.TestSetExecutions" \
    -o "Shared" \
    -s "Smoke Suite" \
    --out junit \
    --result_path "C:\results.xml" \
    --timeout 1800

# uip — three verbs, clean exit-code branching
EXECUTION_ID=$(uip tm testsets run \
    --test-set-key DEMO:10 \
    --output-filter "Data.ExecutionId" \
    --output plain)

if ! uip tm wait --execution-id "$EXECUTION_ID" --project-key DEMO --timeout 1800; then
    case $? in
        2) echo "timeout" >&2; exit 2 ;;
        *) echo "wait failed" >&2; exit 1 ;;
    esac
fi

FAILED=$(uip tm report get --execution-id "$EXECUTION_ID" --project-key DEMO \
    --output-filter "Data.Failed" --output plain)

if [ "$FAILED" -gt 0 ]; then
    uip tm result download --execution-id "$EXECUTION_ID" --project-key DEMO \
        --destination ./results.xml
    exit 1
fi

Hinweise auf Flag-Ebene:

• Legacy -s, --testset <name> hat einen Anzeigenamen; Das neue --test-set-key <key> verwendet den Test Manager-Schlüssel (Format PROJECT:NN). Suchen Sie mit uip tm testsets list --project-key <key>.
• Legacy -t, --testsetkey <key> (ein neueres Legacy-Alias) ist ebenfalls vorhanden – diese Werte werden direkt auf das neue --test-set-key übertragen.
• Legacy --out junit|uipath wird zum neuen uip tm result download --output-format junit ( JUnit ist der Standard; UiPath-native XML wird ebenfalls unterstützt).
• Legacy --attachRobotLogs → Artefakte nach der Ausführung über uip tm attachment download --execution-id <id> anhängen.
• Legacy --retryCount <n> → uip tm executions retry --execution-id <id> führt nur die fehlgeschlagenen Fälle einer abgeschlossenen Ausführung erneut aus. Beim Start gibt es kein automatisches Wiederholungs-Flag; Skripten Sie es mit der report get -Exit-Verzweigung oben.

parallel testen

Es gibt kein uip -Verb, das die Legacy-Version test parallel widerspiegelt. Das nächste Ignom ist eine Shell-Schleife, die mehrere uip tm testsets run -Aufrufe gleichzeitig startet, jeden ExecutionId erfasst und dann auf jeden wartet:

# Launch in parallel (bash)
EXEC1=$(uip tm testsets run --test-set-key DEMO:10 --output-filter Data.ExecutionId --output plain) &
EXEC2=$(uip tm testsets run --test-set-key DEMO:11 --output-filter Data.ExecutionId --output plain) &
wait

# Then wait on each
uip tm wait --execution-id "$EXEC1" --project-key DEMO --timeout 1800 &
uip tm wait --execution-id "$EXEC2" --project-key DEMO --timeout 1800 &
wait

Das Legacy-Schema --testsConfigurationFilePath (mit dem projektspezifische Pfade und deren Testsätze aufgeführt wurden) hat kein uip -Gegenstück; Steuern Sie die Schleife über Ihre CI-Matrix oder eine einfache Shell-Liste von Testsatzschlüsseln.

Asset

Legacy-Befehl	uip gleichwertig ist	Hinweise
uipcli asset deploy <csv> <url> <tenant>	Durchlaufen Sie eine Schleife für uip resource assets create <name> <value> pro Zeile	Entfernt – Ersatz: Iterieren Sie die CSV-Datei in einer Shell-Schleife und rufen Sie create pro Zeile auf. Die neue CLI bietet keine One-Shot-CSV-Bereitstellung; Siehe UIP-Ressourcenassets.
uipcli asset delete <csv> <url> <tenant>	Durchlaufen Sie eine Schleife für uip resource assets delete <key> pro Zeile	Entfernt – Ersatz: Iterieren und Löschen nach Schlüssel. delete nimmt die Asset-GUID, nicht den Namen – lösen Sie Namen zuerst mit uip resource assets list --folder-path <path> in Schlüssel auf.

# Legacy — bulk CSV
uipcli asset deploy "C:\assets.csv" "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Assets" -o "Shared"

# uip — script the loop
# CSV columns: name,type,value,description
while IFS=, read -r NAME TYPE VALUE DESCRIPTION; do
    [ "$NAME" = "name" ] && continue    # skip header
    uip resource assets create "$NAME" "$VALUE" \
        --folder-path Shared \
        --type "$TYPE" \
        --description "$DESCRIPTION"
done < assets.csv

Hinweis:

Assets des Typs Anmeldeinformationen in Legacy verwenden das Wertformular username::password . Bei uip resource assets create ist das Format des Anmeldeinformationswerts username:password (einzelner Doppelpunkt) und Geheimnisse erfordern --credential-store-key <guid>. Siehe UIP-Ressourcenassets – Erstellen.

Lösung

Legacy-Befehl	uip gleichwertig ist	Hinweise
uipcli solution pack <path>	uip solution pack <solutionPath> <outputPath>	1:1 bei Absicht. Die Ausgabe ist eine .zip in beiden Generationen (enthält innere .nupkg -Dateien); Die Argumentform wurde von -o in ein Positionalausgabeverzeichnis geändert.
uipcli solution analyze <path>	uip rpa analyze <project> pro Projekt	N Schritte. Ausführen der Analyse für jedes Projekt innerhalb der Lösung; kein einzelnes uip solution analyze -Verb vorhanden ist.
uipcli solution restore <path>	uip rpa restore <project> pro Projekt	N Schritte. Das gleiche Muster wie solution analyze.
uipcli solution upload-package <zip>	uip solution publish <zip>	1:1. Der neue Name ist publish; Verhalten (Upload in Mandantenlösungsfeed) ist unverändert.
uipcli solution download-package <name> <version>	Kein direktes Äquivalent	Entfernt – Ersatz: Laden Sie die zugrunde liegenden .nupkg Pakete mit uip or packages download <key> herunter oder rufen Sie den veröffentlichten Lösungsdatensatz über die Orchestrator REST API ab.
uipcli solution delete-package <name> <version>	uip solution packages delete <packageName> <packageVersion>	1:1.
uipcli solution download-config <name>	uip solution deploy config get <package-name> [--package-version <v>] [-d <path>]	1:1.
uipcli solution deploy <...>	uip solution deploy run --name <n> --package-name <n> --package-version <v> --folder-name <n> [--folder-path <path>]	1:1 bei Absicht; Flag-Namen geändert. --name ist der Bereitstellungsname , nicht der Paketname. Siehe first-pipeline.md – Schritt 3.
uipcli solution deploy-activate <...>	uip solution deploy activate <deployment-name>	1:1.
uipcli solution deploy-uninstall <...>	uip solution deploy uninstall <deployment-name>	1:1.

# Legacy — pack + upload + deploy, one verb each
uipcli solution pack "C:\my-solution" \
    -o "C:\dist" \
    -v 1.2.0
uipcli solution upload-package "C:\dist\my-solution.1.2.0.zip" \
    "https://cloud.uipath.com/" "TenantName" \
    -A "myOrg" -I "<app-id>" -S "<app-secret>" \
    --applicationScope "OR.Folders"
uipcli solution deploy "..." "..."

# uip — publish replaces upload-package; positional --version in pack
uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant TenantName
uip solution pack ./my-solution ./dist --version 1.2.0
uip solution publish ./dist/my-solution.1.2.0.zip
uip solution deploy run \
    --name "my-solution-deployment" \
    --package-name my-solution \
    --package-version 1.2.0 \
    --folder-name MySolution \
    --folder-path Shared

Eine Anleitung mit Erklärungen zu jedem Schritt finden Sie unter Ihre erste Pipeline .

Ausführen

Legacy-Befehl	uip gleichwertig ist	Hinweise
uipcli run <arguments.json>	Kein direktes Äquivalent	Entfernt – Ersatz: Schreiben Sie den Pipelineschritt als Shell-Skript neu, das uip direkt mit Flags aufruft. Das Legacy-Verb run verbrauchte eine JSON-Datei, die einen vollständigen uipcli <verb> <args> -Aufruf serialisiert hat (erzeugt durch das ausgeblendete --captureCommandToJsonFile -Flag); uip liefert kein Äquivalent.

Hinweis:

Die 1.x-CLI macht kein universelles --from-file -Flag für die Massenargumentwiederholung verfügbar. Wenn Ihre Pipeline von diesem Muster abhängt (häufig bei dem Legacy-Workflow captureCommandToJsonFile + uipcli run ), wandeln Sie die JSON-Nutzlast in direkte uip -Aufrufe um.

Befehle ohne Legacy-Äquivalent

Diese uip -Verben haben kein Gegenstück in der Legacy-CLI; Sie öffnen Workflows, die mit uipcli allein nicht möglich waren. Keine von ihnen erfordert eine Migration – es handelt sich um eine neue Funktion.

• uip login, uip login tenant list/set, uip logout, uip login status – vollständige Sitzungsverwaltung.
• uip or folders *, uip or machines *, uip or users *, uip or roles *, uip or licenses *, uip or sessions *, uip or audit-logs *, uip or calendars *, uip or credential-stores *, uip or feeds *, uip or settings * – vollständige Orchestrator-Administratoroberfläche.
• uip or jobs list / get / stop / restart / resume / logs / traces / healing-data / history, uip or processes list / get / edit / update-version / rollback, uip or packages list / get / versions / entry-points / download – Introspektion-Verben, die Legacy nicht verfügbar gemacht hat.
• uip resource buckets / bucket-files / libraries / queues / queue-items / triggers / webhooks – CRUD für die Orchestrator-Ressource.
• uip agent *, uip codedagent *, uip codedapp *, uip flow *, uip maestro *, uip api-workflow *, uip df *, uip insights *, uip traces *, uip docsai *, uip vss * – völlig neue Oberflächen.
• uip tools *, uip skills *, uip mcp, uip completion – Verwaltung auf Hostebene.

Siehe auch

• Flag-Umbenennungen – jedes Flag, das zwischen uipcli und uip den Namen geändert hat, mit der Zuordnungsregel.
• Durchschlagende Änderungen – semantische Änderungen hinter der Umbenennung (Authentifizierung, Standardformat, Exitcodes).
• Pipeline-Beispiele – vor/nach Azure DevOps- und Jenkins-Pipelines.
• Referenzindex – jedes uip -Tool und Verb an einem Ort.