UIP-Aktualisierung

Syntax und Optionen für „uip update“, das installierte Tools und Fähigkeiten aktualisiert und eine neuere CLI-Version sucht oder anwendet.

uip update aktualisiert jedes installierte Tool und jede installierte Fähigkeit und sucht nach einer neueren CLI-Version (und wendet diese standardmäßig an). Dies ist das Ein-Befehls-Äquivalent der gemeinsamen Ausführung von uip tools update und einer Fähigkeitsaktualisierung sowie der Selbstaktualisierungsprüfung der CLI.

Zusammenfassung

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 berücksichtigt die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag mit einem Zusatz unten.

Optionen

Markieren	Beschreibung
--dry-run	Zeigen Sie eine Vorschau an, was sich ohne Anwenden ändern würde.
--tools-only	Tools aktualisieren; überspringen Sie den Abschnitt „Fähigkeiten“. Sich gegenseitig mit --skills-only und --no-tools ausschließen.
--skills-only	Fähigkeiten aktualisieren; überspringen Sie den Abschnitt Tools. Sich gegenseitig mit --tools-only und --no-skills ausschließen.
--no-tools	Aktualisieren Sie keine Tools.
--no-skills	Fähigkeiten nicht aktualisieren.
--no-cli-check	Suchen Sie auf jeden Fall nicht nach einer neueren CLI-Version.
--no-self	Testen Sie nach einer neueren CLI-Version und melden Sie diese, aber installieren Sie sie nicht – gibt einen Hinweis mit dem manuellen Upgrade-Befehl aus, anstatt eine Selbstaktualisierung durchzuführen.
--channel <channel>	Überschreiben Sie den Versionskanal für diese Ausführung: stable oder preview (siehe UIP-Konfiguration updateChannel). Ohne dieses Flag wird der Kanal von core.updateChannel/dem eigenen Build der laufenden CLI aufgelöst.
--name <tool-name>	Beschränken Sie die Aktualisierung der Tools auf einen Scope-Toolnamen.
--agent <agent>	Beschränken Sie die Aktualisierung der Fähigkeiten auf einen Codierungs-Agent.
--local	Beschränken Sie die Aktualisierung der Fähigkeiten nur auf den lokalen (Projekt-)Scope.
--no-local	Beschränken Sie die Aktualisierung der Fähigkeiten nur auf den globalen Scope.

--tools-only in Kombination mit --no-tools (oder --skills-only in Kombination mit --no-skills) ist ein Konflikt und schlägt mit ValidationError fehl, bevor etwas ausgeführt wird.

Versionsrichtlinie

Es gibt kein Versions-Flag pro Aufruf – uip update zielt immer auf das effektive Versionsziel ab: Ihren core.version -Connector von uip config , wenn einer festgelegt ist, andernfalls die neueste veröffentlichte Version.

• Keine Anheftung – zielt auf die neueste Version ab und überschreitet frei die MINOR- und MaJOR-Grenzen (ein explizites uip update ist der Benutzer, der sich dafür entschieden hat, im Gegensatz zur unbeaufsichtigten täglichen Hintergrundsynchronisierung, die sich selbst begrenzt, um einen unerwarteten MaJOR-Sprung zu vermeiden).
• major.minor Anheftung (eine „linie“-Anheftung, z. B 1.196) – verfolgt den neuesten Patch innerhalb dieser Zeile.
• major.minor.patch Anheftung (eine genaue Anheftung, z. B 1.196.3) – friert Aktualisierungen vollständig ein. uip update überspringt die Aktualisierungs-Engine komplett, gibt einen Success -Umschlag mit jedem Abschnitt aus, der als nicht ausgeführt markiert ist, und gibt eine Warnung an standardr aus, in der der Pins erklärt wird und wie er gelöscht wird (uip config set version <major.minor>, um eine Linie nachzuverfolgen, oder uip config clear version um wieder der aktuellen zu folgen).

Beispiele

# 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

Datenform (--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 ist einer von updated, notice (eine neuere CLI ist vorhanden, wurde aber nicht angewendet – aufgrund von --no-self oder weil die automatische Aktualisierung aus einem anderen Grund abgelehnt wurde), none (bereits aktuell) oder skipped (ein exakter core.version -PIN hat die Ausführung eingefroren – siehe oben). Tools/Skills sind null, kein leeres Array, wenn dieser Abschnitt vollständig übersprungen wurde (--tools-only, --skills-only, --no-tools, --no-skills oder der Kurzschließen mit eingefrorenem Pin).

Bei einer Ausführung mit Cli.action: "notice" wird auch der Befehl für das manuelle Upgrade in ständigrr (npm install -g @uipath/cli@<version> oder einem vom Tool gemeldeten Äquivalent) protokolliert.

Exitcodes

uip update folgt dem Standardvertrag mit einer Ergänzung: Ein Teilfehler gibt immer noch einen Success -Umschlag zurück (der Orchestrator hält nicht beim ersten fehlgeschlagenen Subsystem an – er führt jeden Abschnitt aus und meldet jedes Ergebnis unter Data.Errors), aber der Prozess wird weiterhin ungleich Null beendet, wenn Data.HasFailures true ist. Überprüfen Sie HasFailures und nicht nur Result, wenn ein Skript einen teilweisen Aktualisierungsfehler erkennen muss.

Zugehörig

• uip config – version und updateChannel regeln, was uip update anzielt.
• uip-Tools – uip tools update ist das reine Tools-Äquivalent mit eigenen dedizierten Flags.
• uip Skills – Installation von Fähigkeiten und Verhalten bei der Aktualisierung pro Agent.

Siehe auch

• Globale Optionen
• Exitcodes