Skip to content

Command line arguments

You can call Zeta Test Management (either "zetatest.exe” or directly "zetatest-core.exe”) with command line arguments.

This enables you to e.g. use Zeta Test Management within automatic batch scripts or to change certain default values when the application starts.

Language of the user interface

You can select the graphical user interface either in English or German.

Zeta Test Management automatically selects the language in accordance with the language of your operating system.

If you would like to change the language manually (e.g. if you are working with a German operating system but wish to work with Zeta Test Management in English), simply enter the following command line parameter:

-language=<Language abbreviation>

The following abbreviations, each two letters long, are currently supported:

  • EN: English
  • DE: German

A valid input to start Zeta Test Management in English would be:

C:\Program Files\Zeta Test\Applications\zetatest.exe" -language=en

Importing from Active Directory

Syntax:

-importad <Import configuration to execute>

Description:

Imports users and groups with the specified import configuration from the Active Directory (AD).

Environment variables for managed installations

The Windows client and ServerScheduler can read the following values from their process environment. An explicit command-line value takes precedence, followed by the environment variable and then the existing configuration or saved settings. Empty or whitespace-only environment variables are ignored. An explicitly empty command-line value suppresses the environment fallback for that value.

Environment variable Corresponding command-line value
ZTM_BACKEND_SERVER_URL -backendserverurl
ZTM_BACKEND_SERVER_API_KEY -backendserverapikey
ZTM_LICENSE_KEY -licensekey
ZTM_LANGUAGE -language (de or en)
ZTM_USER_STORAGE_PATH -alternativeCurrentUserStorageBaseFolderPath

Values are read literally and are not inserted into the process command line. Use a full path for ZTM_USER_STORAGE_PATH. The backend URL and API key must refer to the same server. ServerScheduler uses only values relevant to the selected task; setting a variable does not execute a task.

Example for a single PowerShell process:

$env:ZTM_BACKEND_SERVER_URL = 'https://backend.example.org/'
$env:ZTM_LANGUAGE = 'en'
& 'C:\Program Files\Zeta Test Management\Applications\zetatest.exe'

Set API and license keys through protected installation or service configuration, rather than plaintext scripts, manuals or shell history. An environment variable is not an encrypted secret store. After changing user/system variables, restart the application or service from an updated environment. Existing shortcuts with explicit arguments continue to take precedence.

Project paths, login passwords, user names, portable mode and maintenance/import actions are not automatically read from environment variables.

Local web server

The standalone web server additionally supports ZTM_WEB_PORT. The existing --port 18772 argument takes precedence. Valid ports range from 1024 to 65535; a missing or invalid value uses 17238. Binding remains local to localhost. A server automatically started by the Windows client still uses the port explicitly passed by that client.

These variables do not replace the web server settings in appsettings.json or Config.json; this change does not introduce a general environment mapping for all web settings.