UIP の更新

「uip update」の構文とオプション - インストール済みのツールやスキルを更新し、新しいバージョンの CLI を確認または適用します。

uip update は、インストールされているすべてのツールとスキルを更新し、新しい CLI リリースを確認します (既定では適用します)。これは、 uip tools update とスキルの更新を一緒に実行し、さらに CLI 独自の自己更新チェックを行うのと同等の 1 つのコマンドです。

概要

uip update [--dry-run] [--tools-only | --skills-only] [--no-tools] [--no-skills] [--no-cli-check] [--no-self] [--channel <stable|preview>] [--name <tool-name>] [--agent <agent>] [--local | --no-local]

uip update では、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-fileが適用されます。終了コードは 標準契約に従い、以下に 1 つ追加されます。

オプション

フラグ	説明
--dry-run	何が変更されるかを適用せずにプレビューする
--tools-only	ツールを更新する[スキル] セクションはスキップしてください。--skills-only および --no-toolsと相互に排他的です。
--skills-only	スキルを更新する。[ツール] セクションはスキップします。--tools-only および --no-skillsと相互に排他的です。
--no-tools	ツールを更新しないでください。
--no-skills	スキルを更新しない。
--no-cli-check	新しい CLI バージョンを一切検索しないでください。
--no-self	新しい CLI バージョンをプローブして報告しますが、インストールしないでください — 自己更新の代わりに manual upgrade コマンドで通知を出力します。
--channel <channel>	この実行のリリース チャネル ( stable または preview ) を上書きします ( 「uip config updateChannel」を参照)。このフラグがない場合、チャネルは core.updateChannel/実行中のCLIの独自のビルドから解決されます。
--name <tool-name>	ツールの更新は、スコープが設定された 1 つのツール名に限定してください。
--agent <agent>	スキルの更新は 1 つのコーディング エージェントに限定します。
--local	スキルの更新をローカル (プロジェクト) スコープのみに制限してください。
--no-local	スキルの更新をグローバル スコープのみに制限してください。

--no-toolsと組み合わせた--tools-only (または --no-skillsと組み合わせた--skills-onlyは矛盾であり、何かが実行される前に ValidationError で失敗します。

バージョン ポリシー

呼び出しごとのバージョン フラグはありません。uip updateは常に有効なバージョン ターゲットを対象とします。設定されている場合は uip config のcore.version ピン、それ以外の場合は最新のパブリッシュ済みリリース。

• ピンなし — 最新リリースを対象とし、MINOR と MAJOR の境界を自由に越えます (予期しない MAJOR ジャンプを避けるために上限を設ける無人毎日のバックグラウンド同期とは異なり、ユーザーがオプトインする明確な uip update です)。
• major.minorピン(「ライン」ピン、例:1.196) — その行内の最新のパッチを追跡します。
• major.minor.patchピン (正確なピン、例:1.196.3) — 更新を完全にフリーズします。uip update 更新エンジンを完全にスキップし、すべてのセクションが未実行としてマークされた Success エンベロープを出力し、ピンとそのクリア方法を説明する警告をstderrに出力します(uip config set version <major.minor> 行を追跡するか、または uip config clear version して再びlatestをフォローします)。

例

# Update everything installed, including the CLI itself
uip update

# Update tools and skills but only report on a newer CLI, don't self-update
uip update --no-self

# Preview without applying
uip update --dry-run

# Tools only, on the preview channel
uip update --tools-only --channel preview

データシェイプ(--output json)

{
  "Code": "UpdateResult",
  "Data": {
    "DryRun": false,
    "Channel": "stable",
    "Cli": {
      "current": "1.4.2",
      "available": "1.4.3",
      "action": "updated",
      "reason": null
    },
    "Tools": [
      { "name": "orchestrator-tool", "status": "updated", "from": "1.4.2", "to": "1.4.3" }
    ],
    "Skills": { "Sections": [] },
    "Errors": [],
    "HasFailures": false
  }
}

Cli.action は、 updated、 notice (新しい CLI が存在するが、適用されなかった — --no-selfのため、または別の理由で自動更新が拒否されたため)、 none (すでに最新)、または skipped (正確な core.version ピンによって実行がフリーズしました — 上記を参照) のいずれかです。Tools/Skills は、そのセクションが完全にスキップされた場合 (--tools-only、 --skills-only、 --no-tools、 --no-skills、またはフリーズしたピン短絡) null空の配列ではありません。

Cli.action: "notice" で実行すると、手動アップグレード コマンドも stderr (npm install -g @uipath/cli@<version>、またはツールによって報告される同等のもの) に記録されます。

終了コード

uip updateは標準のコントラクトに従いますが、1 つ追加しました。部分的に失敗した場合、Success エンベロープが返されます (Orchestrator は最初に障害が発生したサブシステムで停止しません。すべてのセクションを実行し、各結果を で報告しますData.Errors) が trueのData.HasFailures場合でも、プロセスはゼロ以外で終了します。スクリプトで部分的な更新の失敗を検出する必要がある場合は、 Resultだけでなく、HasFailuresを確認してください。

関連

• UIP 構成 — version と updateChannel で、 uip update のターゲットを制御します。
• UIP ツール — uip tools update はツール専用のツール専用のツールです。
• UIP スキル — スキルのインストールとエージェントごとの更新動作。

参照

• グローバル オプション
• 終了コード