Présentation de la migration

La section Migration est destinée aux équipes qui passent de l'ancienne version .NET CLI (uipcli.exe / dotnet uipcli.dll, version du calendrier 2025.10 et antérieures) vers la version UiPath CLI 1.x (uip, TypeScript sur npm). Les deux CLI sont des fichiers binaires différents avec des formes de commande, des modèles d'authentification et des formats de sortie différents. Cette section vous donne le mappage.

Si vous recommencez de zéro sur 1.x et n’avez pas de pipelines hérités à migrer, ignorez cette section et accédez directement aux guides de démarrage et pratiques.

Les quatre pages

Page	Ce que cela couvre	Lire quand
Migration depuis l’interface CLI.NET héritée	La vue d'ensemble descriptive: ce qui a changé et pourquoi. Indiquez les différences au niveau du runtime, de la distribution, de l'étendue et de la sortie.	Lire d'abord - définit le contexte pour les trois autres.
Carte de commande	Mappage par verbe (uipcli package pack → uip rpa pack, etc.) avec classification (1:1, 2 étapes, supprimé). Extraits avant/après.	Lorsque vous transmettez une invocation uipcli spécifique.
Indicateur des changements de nom	Mappage par indicateur à l'intérieur de chaque verbe (--governanceFilePath → --governance-file-path, -A/--accountForApp → --organization, etc.).	Lorsqu'un verbe est mappé, mais qu'un indicateur est manquant ou renommé.
Changements radicaux	Décalages sémantiques qui affectent chaque commande: modes d'authentification supprimés, lecture implicite env-var supprimée, contrat de code de sortie, format stdout.	Avant tout portage: celles-ci s'appliquent à tous les processus.

Ordre de migration recommandé

Pour une migration de pipeline CI standard:

1. Migrer depuis l’ancienne CLI.NET → comprendre les modifications de l’exécution et de la distribution (.NET → Nœud/Bun, MyGet → npm).
2. Break Changes → avant de changer une seule ligne, sachez quelles sont les différences de coupure. L'authentification seule peut interrompre votre pipeline.
3. Carte de commande → parcourez vos appels uipcli existants un par un. Notez les lignes marquées comme 2 étapes ou N étapes - elles ont besoin d'une nouvelle logique shell, et pas d'un simple changement de nom.
4. Renommage de l'indicateur → remplir le détail par indicateur.
5. Ensuite, une licence CI/CD pour votre plate-forme — copiez et adaptez.

Démarrage rapide pour les impatients

Le port viable minimum:

# 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

Le détail complet par indicateur se trouve dans Renommage d’indicateur.

Ce qu'il ne trouve pas dans la migration

• Nouvelles fonctionnalités dans la version 1.x qui n'ont pas d'équivalent hérité (compétences, MCP, sessions, filtrage JMESPath). Ceux-ci se trouvent dans Nouveautés.
• La documentation de la CLI héritée. Il se trouve toujours dans les documents d’intégration CI/CD, qui restent classiques pour 2025.10 et les versions antérieures.

Voir également

• Nouveautés — résumé, public cible: toute personne ayant décidé de migrer.
• Contrôle des versions et stabilité — le contrat sur lequel vous pouvez vous appuyer après la migration.
• Authentification - le flux d'authentification que votre pipeline utilisera après la migration.