upgrade

Command: upgrade <packages>

Description: You can use this command to update one or more installed packages. Dependent packages are only updated if correspondingly newer minimum versions are specified in the dependencies.

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

Arguments:

<packages>

In this argument, you can specify the package or a list of packages to be updated. If no fixed version is specified, the version that is found first in the feeds according to their priorities will be updated.

Options:

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

When using this option, pre-release versions are also considered.

--params <params>

You can only use these parameters for TwinCAT HMI servers. When this option is used, parameters are provided that are queried and evaluated in the package.

Example: --params "Test1=5 Test2"

--params-sensitive <params-sensitive>

You can only use these parameters for TwinCAT HMI servers. With this option, the parameters used are not written to the log file.

--params-file <params-file>

You can only use these parameters for TwinCAT HMI servers. With this option, you can specify the path to a text file in which the parameters are entered in the following format.

PackageID=Parameters

Please note that only one package is entered per line. To enter parameters for all packages, use "all":

all=Parameters

If you also enter an "*", the parameters are treated as "--params-sensitive" and are not written to the log file.

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

Use this option to prevent queries from being made during installation.

--allow-downgrade

This option allows you to install versions that are lower than those already installed via a downgrade.

-n, --name <name>

This option defines a specific feed in which to search. If no version is specified, the latest version from this feed will be installed.

--all-sources

When using this option, the latest version is used across all configured feeds, regardless of their priority.

--no-cache

When using this option, no cached information is used for this command.

--as-json

If this option is used, the output text is returned in JSON format. This implicitly sets the -y option.

-t, --type <type>

This option can only be used in the "upgrade all" use case to specify which package types are to be updated.

Examples:

All installed workloads should be updated to the latest available version:
tcpkg upgrade all -t Workload

The TwinCAT Standard workload should be upgraded to a specific version:
tcpkg upgrade TwinCAT.Standard.XAE=4026.22.0 TwinCAT.Standard.XAR=4026.22.0

TwinCAT.Standard.XAE is installed in build 4026.18. Now a .co downgrade to build 4026.16 will be performed:

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