mise à jour de l’IU

Syntaxe et options pour `uip update`, qui met à jour les outils et les compétences installés et vérifie ou applique une version de CLI plus récente.

uip update met à jour chaque outil et compétence installés, et recherche (et applique par défaut) une version de CLI plus récente. C'est l'équivalent d'une commande exécutant uip tools update et une mise à jour des compétences ensemble, plus la propre vérification de la mise à jour automatique de la CLI.

Synthèse

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 respecte les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard, avec un ajout ci-dessous.

Options

Drapeau	Description
--dry-run	Prévisualisez ce qui changerait sans l'appliquer.
--tools-only	Mettre à jour les outils; ignorer la section des compétences. mutuellement exclusif avec --skills-only et avec --no-tools.
--skills-only	Mettre à jour les compétences; ignorer la section des outils. mutuellement exclusif avec --tools-only et avec --no-skills.
--no-tools	Ne mettez pas à jour les outils.
--no-skills	Ne mettez pas à jour les compétences.
--no-cli-check	Ne recherchez pas du tout une version de CLI plus récente.
--no-self	Rechercher une version de CLI plus récente et la signaler, mais ne l’installez pas — imprime un avis avec la commande de mise à niveau manuelle au lieu de la mise à jour automatique.
--channel <channel>	Remplacer le canal de publication pour cette exécution: stable ou preview (voir uip config updateChannel). Sans cet indicateur, le canal est résolu à partir de core.updateChannel/propre build de la CLI en cours d'exécution.
--name <tool-name>	Limitez la mise à jour des outils à un nom d’outil d’étendue.
--agent <agent>	Limitez la mise à jour des compétences à un seul agent de codage.
--local	Limitez la mise à jour des compétences à l'étendue locale (projet) uniquement.
--no-local	Limitez la mise à jour des compétences à l'étendue globale uniquement.

--tools-only combiné à --no-tools (ou --skills-only combiné à --no-skills) est une contradiction et échoue avec ValidationError avant toute exécution.

Politique de version

Il n'y a pas d'indicateur de version par invocation - uip update cible toujours la cible de version efficace: votre épingle core.version de uip config si une est définie, sinon la dernière version publiée.

• Pas d'épinglage : cible la dernière version, dépassant librement les limites des capacités mineures et des capacités majeures (l'utilisateur opte pour cette uip update , contrairement à la synchronisation quotidienne sans assistance en arrière-plan, qui se limite pour éviter un saut majeur inattendu).
• major.minor épingle (une épingle « ligne», par ex. 1.196) — suit le dernier correctif de cette ligne.
• major.minor.patch épingle (une épingle exacte, par exemple 1.196.3) — bloque entièrement les mises à jour. uip update ignore complètement le moteur de mise à jour, génère une enveloppe Success avec chaque section marquée comme non exécutée et imprime un avertissement à stderr expliquant le code PIN et comment l'effacer (uip config set version <major.minor> pour suivre une ligne, ou uip config clear version pour suivre à nouveau la dernière version).

Exemples

# 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

Format des données (--sortie 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 est l’un de updated, notice (une version plus récente de la CLI existe mais n’a pas été appliquée — en raison de --no-self, ou parce que la mise à jour automatique a refusé pour une autre raison), none (déjà actuel), ou skipped (une épingle core.version exacte a gelé l'exécution — voir ci-dessus). Tools/Skills sont null, et non un tableau vide, lorsque cette section a été entièrement ignorée (--tools-only, --skills-only, --no-tools, --no-skills, ou le court-code à épingles gelées).

Une exécution avec Cli.action: "notice" enregistre également la commande de mise à niveau manuelle vers stderr (npm install -g @uipath/cli@<version>, ou un équivalent signalé par un outil).

Codes de sortie

uip update suit le contrat standard, avec un ajout: un échec partiel renvoie toujours une enveloppe Success (l'Orchestrator ne s'arrête pas au premier sous-système défaillant — il exécute chaque section et rapporte chaque résultat sous Data.Errors), mais le processus se termine toujours non zéro lorsque Data.HasFailures est true. Vérifiez HasFailures, et pas seulement Result, si un script doit détecter un échec de mise à jour partielle.

Associé

• uip config — version et updateChannel régissent les cibles uip update .
• outils uip — uip tools update est l'équivalent en outils uniquement avec ses propres indicateurs dédiés.
• compétences uip - installation des compétences et comportement de mise à jour par agent.

Voir également

• Options globales
• Codes de sortie