Migration depuis la CLI.NET

UiPath CLI 1.x (uip, distribué sur npm sous le nom @uipath/cli), remplace la CLI.NET héritée (uipcli.exe, distribuée sous le nom UiPath.CLI via les versions de calendrier 2023.10, 2024.10 et 2025.10) . Cette page explique qui doit migrer, les modifications apportées au niveau des outils et comment parcourir les quatre pages de détails ci-dessous.

Si vous souhaitez uniquement la réponse indicateur pour indicateur « que dois-je saisir au lieu de uipcli <verb>?», passez à Carte de commande et Changement du nom de l’indicateur.

À qui s'adresse ce guide

Vous devez effectuer la migration si l'un des éléments suivants s'applique:

• Votre pipeline appelle uipcli.exe — directement, via la UiPathCLI tâche Azure DevOps ou à partir d'une étape du shell Jenkins/GitHub Actions.
• Vous épinglez la CLI héritée à une version de calendrier (2023.10, 2024.10, 2025.10) et suivez sa cadence annuelle.
• Vous utilisez l'authentification utilisateur/mot de passe (-u/-p) ou l'authentification par jeton d'actualisation (-t/-a) contre Orchestrator.
• Vous créez une .nupkg avec uipcli package pack, déployez avec uipcli package deploy ou exécutez des tests Orchestrator avec uipcli test run.

Vous pouvez rester sur la CLI héritée pour l’instant si vous avez besoin d’une fonctionnalité uniquement Windows qui n’a pas encore été portée à l’outil uip rpa multiplate-forme (intégration du débogueur Studio, validate, find-package, find-activities, type-definition). Un outil frères uip rpa-legacy encapsule le binaire 2025.10 sous Windows; consultez uip rpa — wrapper hérité Windows uniquement. Tout le reste — du packaging sur Linux/macOS, les opérations d’Orchestrator, les solutions, Test Manager, Agents, les Flux, Maestro — est dans uip aujourd’hui.

Ce qui change en un coup d’œil

Cote	Héritage uipcli (jusqu’à 2025.10)	uip 1.x
Nom du fichier binaire	uipcli.exe / uipcli.dll	uip
Distribution	MSI, NuGet (UiPath.CLI, UiPath.CLI.Windows)	npm (@uipath/cli)
Runtime	.NET 6/Infrastructure.NET	Node.js 18+
Plate-forme	Windows (principal), Linux via NuGet multiplate-forme	Windows, macOS, Linux, ARM64
Contrôle de version	Calendrier (2023.10, 2024.10, 2025.10)	Sémantique (1.0.0, 1.1.0, 2.0.0)
Installer le modèle	Monolithique	Hôte + plug-ins d'outil par surface (voir Outils)
Sortie par défaut	Texte des journaux vers stdout + code de sortie	Enveloppe JSON sur stdout, se connecte sur stderr
Flux d'authentification principal	utilisateur/pass, actualiser le jeton, application externe	application externe (CI), OAuth interactive (développement), env-token (conteneur)
Configuration	Indicateurs CLI uniquement	Indicateurs + variables d'environnement (voir Configuration)

Consultez la section Nouveautés pour obtenir un résumé de la réécriture.

Sur quelle version de CLI est-ce que j'utilise?

Exécutez uipcli --version (ou dotnet uipcli.dll --version). La sortie se présente sous la forme 23.10.8817.35919, 24.10.9248.xxxxx ou 25.10.xxxx.xxxxx. Les chemins de migration ci-dessous couvrent ces trois possibilités.

Vous êtes en cours d'exécution	Où aller
uipcli 23.10.*	Lire cette page entière, puis Carte de commande + Renommer l'indicateur. Les verbes deploy et asset deploy que vous utilisez sont tous mappés.
uipcli 24.10.*	Identique à la version 23.10, — l'interface de la commande a à présent été modifiée. Si vous avez adopté le verbe solution ajouté dans la version 24.10, chaque sous-commande est mappée.
uipcli 25.10.*	Identique à ci-dessus. test parallel et le formulaire de déploiement à points d'entrée multiples --processNames <csv> ont des notes de migration spécifiques dans la carte de commande.
Utilisation de uipcli run <args.json>	Voir Carte de commande — exécution — la nouvelle CLI n'a pas d'équivalent direct; le modèle recommandé est un script shell avec une invocation uip par étape.

Table de décision — choisissez votre point de départ

Votre cas d’utilisation sur uipcli	Cible de la migration	Page de détail
Compresser un projet Studio → télécharger dans Orchestrator → créer un processus	uip rpa pack → uip or packages upload → uip or processes create	Carte de commande — package
Créer et déployer une solution (.uipx)	uip solution pack → uip solution publish → uip solution deploy run	Carte de commande — solution, premier pipeline
Démarrer une tâche Orchestrator	uip or jobs start <process-key> [--wait-for-completion]	Carte de commande — tâche
Exécuter un ensemble de tests Test Manager	uip tm testsets run → uip tm wait → uip tm report get	Carte de commande — test
Déployer les ressources déclarées au format CSV	uip resource assets create dans une boucle (aucun déploiement de fichier CSV à usage unique aujourd'hui)	Carte de commande — ressource
Exécuter l’analyseur de workflow	uip rpa analyze <project> --governance-file-path <policy>	Carte de commande - analyser
Authentifier un pipeline CI	uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant <name>	Indicateur des changements de nom — auth
Porter un pipeline Azure DevOps / Jenkins	Remplacer UiPathCLI blocs de tâches par uip étapes du shell	Exemples de pipelines

Modifications avec rupture les plus courantes

Ces trois apparaissent dans presque chaque migration. Voir Modifications radicales pour la liste complète.

1. L'authentification de base (-u/-p) et le jeton d'actualisation (-t/-a) ont été supprimées. Seuls les informations d’identification du client d’application externe, l’activité OAuth2 interactive et les jetons d’accès variables dans l’environnement sont pris en charge. Voir Authentification.
2. UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET ne sont plus lus implicitement. Transmettez-les sous la forme --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET (le préfixe env. lit la variable sans l'exposer sur la ligne de commande).
3. Stdout est JSON par défaut. Les scripts Shell hérités qui ont analysé la sortie de uipcli texte doivent utiliser jq (ou --output plain + --output-filter) ou basculer sur --output table pour la lecture humaine.

Avant de commencer

Effectuez ces quatre étapes avant de commencer à porter un pipeline.

1. Sauvegardez vos fichiers de pipeline actuels

Validez une copie connue de chaque azure-pipelines.yml, Jenkinsfile, .github/workflows/*.yml ou .gitlab-ci.yml sur une branche (ou une balise). Le port est plus facile à examiner en tant que diff.

2. Épingler @uipath/cli à une version spécifique

Installez toujours avec une version explicite pendant la migration afin que le comportement du pipeline ne change pas de manière inattendue:

npm install -g @uipath/cli@1.0.0

Les outils sont attachés implicitement à la ligne MAJOR.MINOR de la CLI (voir Contrôle des versions), de sorte qu'une CLI épinglée épingle également chaque outil à une plage mineure connue. Pour une reproductibilité stricte au niveau du correctif, épinglez également les outils - voir la section « Épingler les versions dans CI» de Modèles de script.

3. Ajoutez aux documents de la CLI.NET héritées

Effectuez une référence croisée du comportement des indicateurs pendant le port. La référence 2025.10 se trouve sur docs.uipath.com — Interface de ligne de commande UiPath (2025.10). Gardez-la ouverte dans un onglet.

4. Créer une application externe dans UiPath

La CLI héritée acceptait plusieurs modes d’authentification; la nouvelle CLI réduit l'authentification CI aux informations d'identification du client d'application externe. Créez l'application maintenant pour que le port ait quelque chose à indiquer. Voir Authentification — Flux 2.

Astuce :

Accordez à l'application externe les mêmes étendues que votre CLI héritée utilisée — OR.Folders, OR.Jobs, OR.Execution, OR.Assets, OR.Users.Read, OR.Machines.Read, OR.TestSets, OR.TestSetExecutions couvre le cas CI courant. Consultez la valeur --applicationScope de vos appels uipcli existants pour obtenir la liste exacte dont vous avez besoin.

Les quatre pages de détails

Chaque page ci-dessous est suffisamment ciblée pour être examinée en une seule session. Parcourez-les dans l'ordre si vous portez un pipeline complet; passez directement à celle dont vous avez besoin si vous voulez uniquement une réponse spécifique.

Carte de commande

Chaque verbe hérité — package pack, package analyze, package deploy, package restore, job run, test run, test parallel, asset deploy, asset delete, solution pack, solution deploy, run — avec son équivalent uip , une classification 1:1/multi-étapes/supprimée et un extrait de shell avant/après pour chaque ligne non triviale.

Indicateur des changements de nom

Mappage au niveau de l'indicateur avec le bloc d'authentification en haut. Héritage -u/-p/-t/-a/-A/-I/-S/-o/--applicationScope/--identityUrl/--outputType/--traceLevel mappé à leurs homologues uip (ou invoqués comme supprimés, avec le remplacement). Lisez ceci avec la carte de commande - la carte de commande affiche le verbe, l'indicateur renomme l'indicateur.

Changements radicaux

Couverture Prose des modifications qui entraînent l'interruption des pipelines sans avertissement. Suppressions en mode authentification, suppression de la lecture automatique de l'env-var, renforcement du contrat de code de sortie, JSON-stdout par défaut, dossiers NuGet avec version du calendrier supprimés, runtime.NET supprimé. Un paragraphe par modification avec une correction « que faire».

Pipelines

Extraits avant/après pour Azure DevOps et Jenkins (obligatoire), avec des actions GitHub plus courtes et des extraits GitLab CI. Lien croisé vers les formules CI/CD complètes pour les pipelines complets.

Voir également

• Nouveautés - Résumé de la réécriture.
• Votre premier pipeline — présentation pratique de pack → publish → deploy run avec la nouvelle CLI.
• Authentification — les trois flux d'authentification pris en charge dans 1.x.
• Codes de sortie — le contrat à cinq niveaux renforcées.
• Outils (extensions) : pourquoi la surface de commande est divisée entre les packages npm et ce qui s’installe automatiquement lors de la première utilisation.