Migration: carte de commande

Chaque verbe uipcli hérité avec son équivalent uip . Les entrées héritées reflètent l'apparence publique uipcli documentée pour 2025.10 et les versions antérieures; la colonne uip correspond aux pages de référence publiées.

Comment lire cette page. Les lignes sont regroupées par famille de verbes hérités (package, job, test, asset, solution, run). Chaque ligne comporte une classification:

• 1:1 — changement de nom direct; le nouvel ensemble d'indicateurs est suffisamment proche pour qu'un port technique fonctionne.
• 2 étapes / N étapes — un verbe hérité correspond à plusieurs appels uip .
• Supprimé — remplacement:... — le verbe hérité n'a pas de successeur direct; la colonne « remplacement» vous indique le flux idiosique de la nouvelle CLI pour le même résultat.

Pour plus de détails au niveau de l’indicateur à l’intérieur de chaque verbe, consultez Changements de nom de l’indicateur. Pour les modifications d'authentification/de sortie sous-jacentes qui s'appliquent à chaque verbe, consultez Changements de rupture.

Paquet

Commande héritée	uip équivalent	Remarques
uipcli package pack <project>	uip rpa pack <project>	1:1. La nouvelle surface d’indicateur utilise kebab-case; --outputType → --output-type, --autoVersion → --auto-version, etc. Les commandes uip rpa invoquent le package Studio, qui est basé sur.NET - l'exécuteur a toujours besoin d'un runtime.NET disponible. Voir le pack rpa uip.
uipcli package analyze <project>	uip rpa analyze <project> --governance-file-path <policy>	1:1. --governanceFilePath devient --governance-file-path . Les règles de l’analyseur de workflow sont inchangées. Le backend.NET s'applique, de la même manière que rpa pack. Voir analyse uip rpa.
uipcli package deploy <path> <url> <tenant>	uip or packages upload <path> Puis (Then) uip or processes create --name <n> --package-key <k> --package-version <v> --folder-path <path>	2 étapes. Le déploiement hérité télécharge le .nupkg et crée un processus en un appel; la nouvelle CLI divise ces préoccupations. Voir uip ou téléchargement de packages et uip ou processus créés.
uipcli package restore <project>	uip rpa restore <project> [outputPath]	1:1. Restaure les dépendances du package NuGet; prend en charge les configurations NuGet personnalisées et physiquement isolées via les mêmes indicateurs que l'héritage. Le backend.NET s’applique. Voir restauration uip rpa.

Mise en package du package

# 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

Consultez le pack rpa uip pour obtenir la liste complète des indicateurs. L’outil encapsule le même packeur Studio que la CLI héritée utilisée, de sorte que le format de sortie et la prise en charge du projet sont identiques.

Analyse des packages

# 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

Déploiement du paquet

Il s'agit de la ligne qui capture chaque port de pipeline. L’héritage deploy est un processus de téléchargement et de création unique; uip le divise en deux étapes explicites pour que le package puisse être téléchargé une fois et lié à plusieurs dossiers.

# 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

Remarque :

• Les valeurs <orchestrator_url> et <orchestrator_tenant> de position héritées sont remplacées par le contexte de session de uip login (plus remplacement facultatif -t, --tenant sur chaque appel). Ils n'apparaissent jamais comme des arguments de position dans uip.
• Héritage --processName est un nom complet personnalisé pour le processus créé. Dans uip l’équivalent est --name sur processes create — non --process (qui n’existe pas).
• L'héritage --processNames <csv> (création en bloc multi-processus dans 25.10) n'a pas d'équivalent direct; scriptez une boucle sur les lignes ou lisez Solutions pour le flux multi-processus recommandé.
• L’héritage --entryPointsPath devient --entry-point (chemin unique) sur uip or processes create; exécutez processes create une fois par point d'entrée pour les packages multi-points d'entrée.

restauration du package

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

# uip
uip rpa restore ./proj ./deps

Job

Commande héritée	uip équivalent	Remarques
uipcli job run <processName> <url> <tenant>	uip or jobs start <process-key>	1:1 sur l'intention; (Identity) est un GUID, et non un nom. La CLI héritée prenait le nom de la version du processus comme argument de position. la nouvelle CLI prend la clé de processus renvoyée par uip or processes list. Utilisez --wait-for-completion pour le comportement hérité -w true + -W <timeout> . Voir uip ou tâches.

# 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

Détails au niveau de l’indicateur:

• L'héritage -i, --input_path <file> → uip offre deux alternatives: --input-arguments '<json>' pour JSON en ligne, ou --input-file <path> pour une charge utile de fichier. Ils s'excluent mutuellement.
• Héritage -j, --jobscount <n> → --jobs-count <n>.
• Héritage -P, --priority <Low|Normal|High> → --job-priority <Low|Normal|High>.
• Héritage -r, --robots <csv> → aucun équivalent direct (concept de dossier classique uniquement dans l'héritage). Cibler les machines avec --machine-keys <csv> ou les utilisateurs avec --user-keys <csv> .
• Héritage -f, --fail_when_job_fails (par défaut true) → la nouvelle CLI se termine toujours 1 si une tâche attendue se termine Faulted; il n'y a pas de refus.
• Héritage -R, --result_path <file> → la nouvelle CLI imprime l'enveloppe de la tâche au format stdout; rediriger avec > result.json, ou utiliser --output-filter pour extraire des champs spécifiques.
• Héritage -b, --job_type <Unattended|NonProduction> → --runtime-type <Unattended|Headless|Serverless|NonProduction|Development|TestAutomation>.

test

Commande héritée	uip équivalent	Remarques
uipcli test run <url> <tenant> -s <testset>	uip tm testsets run --test-set-key <key> Puis (Then) uip tm wait --execution-id <id> Puis (Then) uip tm report get --execution-id <id>	3 étapes (lancer → attendre → vérifier). La nouvelle CLI sépare « déclencher l'exécution» de « bloquer» de « lire le verbe», afin que les scripts CI puissent se ramifier correctement sur chacun. Voir Exécution des ensembles de tests uip tm. Le nouveau verbe réside dans la ressource testsets en tant que uip tm testsets run , et non dans la ressource executions (il n'y a pas de uip tm executions run).
uipcli test run <url> <tenant> -P <project.json> (compresser + tester un projet)	uip rpa pack → uip or packages upload → créer un ensemble de test dans Test Manager → uip tm testsets run	N étapes. Le flux unique hérité « compresser ce projet, le déployer, exécuter ses tests» est réparti entre les outils rpa, or et tm . La création de l’ensemble de tests est généralement une configuration unique effectuée dans l’interface utilisateur Web de Test Manager.
uipcli test parallel <url> <tenant> --testsConfigurationFilePath <file>	Pas d’équivalent direct — en boucle sur uip tm testsets run appels	Supprimé — remplacement: scriptez un lancement parallèle d'ensembles de test indépendants avec uip tm testsets run (chacun renvoie une ExecutionId), puis une seule uip tm wait par exécution. Le pilote de projet de test du verbe parallel (qui a invoqué uipcli test run en interne) n’a pas d’équivalent; le nouveau modèle suppose que les ensembles de tests sont déjà créés dans Test Manager.

exécution de test (ensemble de test unique)

# 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

Remarques au niveau de l'indicateur:

• L'héritage -s, --testset <name> prend un nom complet; le nouveau --test-set-key <key> prend la clé Test Manager (au format PROJECT:NN). Recherchez-le avec uip tm testsets list --project-key <key>.
• L’héritage -t, --testsetkey <key> (un alias hérité plus récent) existe également — ces valeurs sont portées directement au nouveau --test-set-key.
• L'héritage --out junit|uipath devient le nouveau uip tm result download --output-format junit (JUnit est la valeur par défaut; le XML natif UiPath est également pris en charge).
• Héritage --attachRobotLogs → joindre des artefacts via uip tm attachment download --execution-id <id> après l’exécution.
• Héritage --retryCount <n> → uip tm executions retry --execution-id <id> réexécute uniquement les cas ayant échoué d’une exécution terminée. Il n'y a pas d'indicateur de réessai automatique au lancement; scriptez-le avec la branche report get ci-dessus.

Test parallèle

Aucun verbe uip ne reflète l'héritage test parallel. L'ID le plus proche est une boucle shell qui lance plusieurs appels uip tm testsets run simultanément, capture chaque ExecutionId, puis attend pour chacun:

# 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

Le schéma --testsConfigurationFilePath hérité (qui répertorie les chemins par projet et leurs ensembles de test) n'a pas d'équivalent uip ; piloter la boucle à partir de votre matrice CI ou d'une simple liste shell de clés d'ensemble de test.

Ressource

Commande héritée	uip équivalent	Remarques
uipcli asset deploy <csv> <url> <tenant>	Passer uip resource assets create <name> <value> par ligne	Supprimer — remplacement: itérez le fichier CSV dans une boucle shell et appelez create par ligne. La nouvelle CLI ne propose pas de déploiement CSV en un coup; consultez la section Ressources de ressources UIP.
uipcli asset delete <csv> <url> <tenant>	Passer uip resource assets delete <key> par ligne	Supprimer — remplacement: itérer et supprimer par clé. delete prend le GUID de la ressource, et non le nom - résolvez les noms en clés d'abord avec uip resource assets list --folder-path <path>

# 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

Remarque :

Les ressources de type Credential (Informations d'identification) héritées utilisent le formulaire de valeur username::password . Avec uip resource assets create, le format de la valeur des informations d’identification est username:password (deux-points uniques), et les secrets nécessitent --credential-store-key <guid>. Voir Ressources de ressources UIP — Créer.

Solution

Commande héritée	uip équivalent	Remarques
uipcli solution pack <path>	uip solution pack <solutionPath> <outputPath>	1:1 sur l'intention. La sortie est un .zip dans les deux versions (contient des fichiers .nupkg internes); la forme de l'argument est passée de -o à un répertoire de sortie positionnel.
uipcli solution analyze <path>	uip rpa analyze <project> par projet	N étapes. Exécutez l’analyseur sur chaque projet à l’intérieur de la solution; il n'y a pas de verbe uip solution analyze unique.
uipcli solution restore <path>	uip rpa restore <project> par projet	N étapes. Même modèle que solution analyze.
uipcli solution upload-package <zip>	uip solution publish <zip>	1:1. Le nouveau nom est publish; le comportement (téléchargement dans le flux de solution du locataire) est inchangé.
uipcli solution download-package <name> <version>	Pas d’équivalent direct	Supprimer — remplacement: téléchargez le .nupkg package(s) sous-jacent avec uip or packages download <key>, ou récupérez l'enregistrement de la solution publiée via l'API REST d'Orchestrator.
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 sur l'intention; les noms des indicateurs ont changé. --name correspond au nom du déploiement , et non au nom du package. Voir first-pilote.md — Étape 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

Consultez Votre premier pipeline pour obtenir une présentation avec des explications pour chaque étape.

Exécuter

Commande héritée	uip équivalent	Remarques
uipcli run <arguments.json>	Pas d’équivalent direct	Supprimer — remplacement: réécrivez l'étape de pipeline sous forme de script shell qui appelle uip directement avec des indicateurs. Le verbe run hérité utilisait un fichier JSON qui sérialisait une invocation uipcli <verb> <args> complète (produite par l'indicateur --captureCommandToJsonFile masqué); uip ne fournit pas d’équivalent.

Remarque :

La CLI 1.x n’expose pas un indicateur --from-file universel pour la rediffusion d’arguments en bloc. Si votre pipeline dépend de ce modèle ( commun avec le workflow captureCommandToJsonFile + uipcli run hérité), convertissez la charge utile JSON en invocations uip directes.

Commandes sans équivalent hérité

Ces verbes uip n’ont pas d’équivalent dans la CLI héritée; elles ouvrent des workflows qui n'étaient pas possibles avec uipcli seul. Aucun d’eux ne nécessite de migration — il s’agit d’une nouvelle fonctionnalité.

• uip login, uip login tenant list/set, uip logout, uip login status — gestion complète de la session.
• 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 * — interface d'administration Orchestrator complète.
• 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 — verbes d'introduction qui n'étaient pas exposés.
• uip resource buckets / bucket-files / libraries / queues / queue-items / triggers / webhooks — CRUD de la ressource Orchestrator.
• uip agent *, uip codedagent *, uip codedapp *, uip flow *, uip maestro *, uip api-workflow *, uip df *, uip insights *, uip traces *, uip docsai *, uip vss * — toutes les nouvelles interfaces.
• uip tools *, uip skills *, uip mcp, uip completion — gestion au niveau de l'hôte.

Voir également

• Changement de nom d'indicateur — chaque indicateur ayant changé de nom entre uipcli et uip, avec la règle de mappage.
• Changements radicaux — modifications sémantiques derrière le changement de nom (auth, format stdout, codes de sortie).
• Exemples de pipelines — avant/après les pipelines Azure DevOps et Jenkins.
• Index de référence — tous les outils uip et verbes en un seul endroit.