upgrade

Befehl: upgrade <packages>

Beschreibung: Mit diesem Befehl können Sie ein oder mehrere installierte Pakete aktualisieren. Davon abhängige Paket werden nur dann auch aktualisiert, wenn entsprechend neuere Minimalversionen den Abhängigkeiten eingetragen sind.

Verwendung: tcpkg upgrade <packages>... [options]

Argumente:

<packages>

In diesem Argument können Sie das Paket oder eine Liste von Paketen, die aktualisiert werden sollen, angeben. Falls keine feste Version angegeben wird, wird die Version aktualisiert, die als erstes in den Feeds nach deren Prioritäten gefunden wird.

Optionen:

-p, --pre, --include-prereleases

Bei der Verwendung dieser Option werden auch Pre-Release-Versionen betrachtet.

--params <params>

Diese Parameter können Sie nur für TwinCAT HMI Server verwenden. Bei der Verwendung dieser Option werden Parameter mitgegeben, die im Paket abgefragt und ausgewertet werden.

Bsp.: --params „Test1=5 Test2“

--params-sensitive <params-sensitive>

Diese Parameter können Sie nur für TwinCAT HMI Server verwenden. Bei dieser Option werden die verwendeten Parameter nicht mit in die Log-Datei geschrieben.

--params-file <params-file>

Diese Parameter können Sie nur für TwinCAT HMI Server verwenden. Bei dieser Option können Sie den Pfad zu einer Textdatei angeben, in der die Parameter in folgendem Format eingetragen sind.

PackageID=Parameters

Dabei muss beachtet werden, dass nur ein Paket pro Zeile eingetragen wird. Falls Sie Parameter für alle Pakete eintragen wollen, können Sie „all“ verwenden:

all=Parameters

Wenn Sie zusätzlich ein „*“ eintragen, werden die Parameters als „--params-sensitiv“ behandelt und nicht in die Log-Datei geschrieben.

-y, --bypass, --bypass-confirmation, --no-prompt

Mit dieser Option können Sie verhindern, dass Abfragen während der Installation gestellt werden.

--allow-downgrade

Die Verwendung dieser Option ermöglicht es, dass auch kleinere Versionsnummern als die bereits installierten über ein Downgrade installiert werden können.

-n, --name <name>

Diese Option definiert einen spezifischen Feed, in dem gesucht werden soll. Falls keine Version mit angegeben wird, wird die neuste Version aus diesem Feed installiert.

--all-sources

Bei der Verwendung dieser Option wird über alle konfigurierten Feeds hinweg, ohne deren Priorität zu beachten, die neuesten Versionen verwendet.

--no-cache

Bei der Verwendung dieser Option werden bei diesem Befehl keine zwischengespeicherten Informationen verwendet.

--as-json

Bei der Verwendung dieser Option wird der Ausgabetext im JSON-Format zurückgegeben. Dabei wird die Option -y implizit gesetzt.

-t, --type <type>

Diese Option kann nur im Use Case „upgrade all“ verwendet werden, um zu spezifizieren, welche Pakettypen aktualisiert werden sollen.

Beispiele:

Es sollen alle installierten Workloads auf die neuste verfügbare Version aktualisiert werden:
tcpkg upgrade all -t Workload

Es soll auf eine bestimmte Version des TwinCAT Standard Workloads geupgraded werden:
tcpkg upgrade TwinCAT.Standard.XAE=4026.22.0 TwinCAT.Standard.XAR=4026.22.0

TwinCAT.Standard.XAE ist im Build 4026.18 installiert. Nun wir ein .co ein Downgrade auf Build 4026.16 durchgeführt werden:

tcpkg upgrade twincat.standard.xae=4026.16 --allow-downgrade