移行の概要

[移行] セクションは、レガシ .NET CLI (uipcli.exe / dotnet uipcli.dll、カレンダー バージョン管理された 2025.10 以前) から UiPath CLI 1.x (uip、npm 上の TypeScript) に移行するチームを対象としています。2 つの CLI は、コマンドの形状、認証モデル、出力形式が異なる異なるバイナリです — このセクションでは、マッピングを示します。

1.x で新規に開始し、移行するレガシ パイプラインがない場合は、 このセクションをスキップ して、 概要 と 操作ガイドに直接進んでください。

4 つのページ

ページ	カバーされる内容	次の場合に読んでください
レガシ .NET CLI から移行する	物語の概要:何が変わったのか、そしてその理由。実行時間、分布、スコープ、出力における主な違い。	最初に読む — 他の3つのコンテキストを設定します。
コマンド マップ	動詞ごとのマッピング (uipcli package pack → uip rpa packなど) と分類 (1:1、2 ステップ、削除)。Before/After スニペット。	特定の uipcli 呼び出しを移植する場合。
フラグの名前の変更	各動詞内のフラグごとのマッピング (--governanceFilePath → --governance-file-path、 -A/--accountForApp → --organizationなど)。	動詞がマップされているが、フラグが見つからないか、名前が変更されている場合。
重大な変更	すべてのコマンドに影響を与えるセマンティックシフト:認証モードの削除、暗黙的な環境変数の読み取りの削除、終了コードコントラクト、stdout形式。	移植の前に、これらは全面的に当てはまります。

推奨される移行順序

一般的な CI パイプラインの移行の場合:

1. レガシ .NET CLI から移行する → ランタイムとディストリビューションの変更(.NET → Node/Bun、MyGet → npm)を理解します。
2. 重大な変更 → 1 つの行を変更する前に、横断的な違いが何であるかを把握します。認証だけではパイプラインが破損する可能性があります。
3. コマンドマップ →既存の uipcli 呼び出しを1つずつウォークします。2ステップまたはNステップとマークされた行に注意してください—単純な名前の変更ではなく、新しいシェルロジックが必要です。
4. フラグは名前を変更して →フラグごとの詳細を埋めます。
5. 次に、プラットフォームの CI/CDレシピ — コピーして適応します。

せっかちな人のためのクイックスタート

実行可能な最小ポート:

# 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

フラグごとの完全な詳細は 、「フラグの名前の変更」にあります。

移行に含まれていない内容

• レガシーに相当するものがない1.xの新機能(スキル、MCP、セッション、JMESPathフィルタリング)。それらは What's Newに住んでいます。
• レガシ CLI のドキュメント。CI /CD との連携に関するドキュメントには現在も存在しており、 2025.10 以前については正規のままです。

参照

• 新機能 — ヘッドラインの概要、ターゲット ユーザー: 移行するかどうかを決定するすべてのユーザー。
• バージョン管理と安定性 — 移行後に信頼できるコントラクト。
• 認証 — 移行後にパイプラインが使用する認証フローです。