Bedienung über Kommandozeile (RT Unified) - WinCC Unified

SIMATIC Runtime Manager (RT Unified)
ft:publication_title
SIMATIC Runtime Manager (RT Unified)
Product
WinCC Unified
Version
V20
Publication date
06/2025
Language
de-DE
Bedienung über Kommandozeile

SIMATIC Runtime Manager besitzt eine Schnittstelle, mit der Sie zahlreiche Funktionen von Runtime Manager über ein Kommandozeilenprogramm starten können.

Voraussetzung

  • Runtime und Kommandozeilenprogramm sind auf dem gleichen Gerät installiert.

  • Für das Starten/Stoppen von Projekten: In die Runtime wurden Projekte geladen.

Vorgehen

  1. Starten Sie das Kommandozeilenprogramm.

  2. Geben Sie den Kommandozeilenaufruf ein. Trennen Sie die einzelnen Elemente des Aufrufs durch Leerzeichen.

    • Geben Sie den Pfad zur SIMATIC Runtime Manager.exe ein:

      "<Runtime-Installationsverzeichnis>\bin> start /wait SIMATICRuntimeManager.exe"

      Beispiel: C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe

    • Geben Sie ein, mit welchen Optionen das Kommandozeilenprogramm Runtime Manager aufruft.

      Die letzte Option muss "-c" sein.

      Option

      Beschreibung

      -s

      Option zum Start von Runtime Manager im Silent Mode.

      Ohne diese Option wird bei der Verarbeitung des Kommandozeilenaufrufs die UI von Runtime Manager gestartet.

      -u

      Option zur Aktivierung von Hilfsmeldungen, die Sie bei der Bedienung von Runtime Manager über das Kommandozeilenprogramm unterstützen

      -sim

      Verwenden Sie diese Option nur, wenn Sie die Option "-c" mit dem Befehl projectstate, start, stop oder remove aufrufen.

      -quiet

      Option zum Aufruf von Runtim Manager ohne Ausgabe.

      -o

      Option zum Umleiten der Ausgabe in eine Datei Output.txt, die parallel zur SIMATICRuntimeManager.exe abgelegt wird.

      Sie können die Ausgabe in einen anderen Ordner umleiten. Der Unified Administrator muss Schreibzugriff auf den Ordner haben.

      Beispiel:

      -o “C:\Program Files\Siemens\Automation\WinCCUnified\bin\MyOutput.txt"

      Wenn beim Schreiben ein Fehler auftritt und -quiet nicht gesetzt ist, erfolgt die Fehlerausgabe in der Konsole.

      -keepUmc

      Optional

      Nur in Kombination mit dem Befehl fulldownload

      Setzen Sie die Option, um die UMC-Daten der Runtime zu behalten.

      -overwriteUmc

      Optional

      Nur in Kombination mit dem Befehl fulldownload

      Setzen Sie diese Option um die UMC-Daten der Runtime mit den UMC-Daten aus dem Projekt zu ersetzen.

      -c

      Option zur Eingabe der Befehle, die an Runtime Manager übergeben werden.

    • Geben Sie nach der Option "-c" den Befehl ein, den der Runtime Manger ausführen soll, und das Argument, das an den Befehl übergeben wird:

      Befehl

      Argument

      Beschreibung

      start

      <Projekt-ID>

      Startet das Projekt.

      stop

      <Projekt-ID>

      Stoppt das Projekt.

      projectlist

      [ALL] oder [RUNNING]

      Default: [ALL]

      [ALL]: Liefert eine Liste, der in die Runtime geladenen Projekte.

      [RUNNING]: Liefert das in Runtime laufende Projekt.

      projectstate

      <Projekt-ID>

      Liefert den Status des in Runtime laufenden Projekts.

      remove

      <Projekt-ID>

      Entfernt das Projekt aus Runtime.

      Wenn für das Projekt zuvor die Autostart-Option gesetzt wurde: Entfernt die Autostart-Option.

      securemode

      <Passwort>

      Setzt das Passwort für die sichere Kommunikation mit SCS.

      Geben Sie das gleiche Passwort ein, das die Runtime für die sichere Kommunikation verwendet.

      setautostart

      <Projekt-ID>

      Das Projekt wird beim Hochfahren des Geräts gestartet.

      Das Projekt muss den Typ Project haben.

      Die Option kann nur für 1 Projekt gesetzt sein.

      removeautostart

      <Projekt-ID>

      Entfernt den Autostart des Projekts.

      fulldownload

      <Archiv-Pfad>

      Startet das vollständige Laden eines TIA Portal-Archivs.

      Wenn das Projekts bereits in Runtime läuft, wird es vor dem vollständigen Laden zuerst gestoppt.

      Um das Projekt nach dem erfolgreichen Laden zu starten, verwenden Sie den Befehl start.

      deltadownload

      <Archiv-Pfad>

      Startet das Änderungsladen eines TIA Portal-Archivs.

      Prüfen Sie vorab, ob das entsprechende Projekt in Runtime geladen ist und läuft.

      Um mehrere Befehle auszuführen, verwenden Sie mehrere Kommandozeilenaufrufe.

  3. Drücken Sie Enter.

Ergebnis

  • Der Befehl wird ausgeführt.

  • In der Konsole wird ein Rückgabe-Code mit Beschreibung ausgegeben.

    Liste der möglichen Rückgabe-Codes:

    Rückgabe-Code

    Beschreibung

    0x00000000

    Success

    0x0080400b

    Project already running

    0x0080400c

    Project started

    0x0080400d

    Project already stopped

    0x0080400e

    Project stopped

    0x80000000

    General error

    0x80000001

    Not supported (e. g. wrong command)

    0x80000003

    Timeout during communication with SCS

    0x80000004

    Invalid arguments

    0x80000005

    Access denied – password required for secure connection

    0x8000000C

    Another project is currently flagged as autostart project, remove autostart from the other project

    0x80000016

    Unable to connect to SCS

    0x80804019

    Project not found

    0x80B0412E

    Write output file error

    0x80B0412F

    Autostart option cannot be set on simulation project

    0x80B04130

    Empty command value

    0x80B04131

    archive target path could not be created

    0x80B04132

    project archive can not be extracted

    0x80B04133

    DownloadTask file can not be read

    0x80B04134

    Could not change UMC Data override option

    0x80B04135

    Missing config folder in archive

    0x80B04136

    Missing delta folder in archive

  • In die Konsole bzw. in die Ausgabedatei wird eine Ausgabe geschrieben.

    Voraussetzung: Der Befehl wurde ohne die Option -quiet aufgerufen.

Beispiele

  • Eine Liste aller in die Runtime geladenen Projekte abrufen:

    • Eingabe: C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c projectlist [ALL]

    • Ausgabebeispiel:

      [1]

      Project name: T1

      Device name: T1

      Project type: Project

      Project ID: 0B527D12-6BBD-4F2F-BEB9-23E3C37A8932

      Autostart: 0

      [2]

      Project name: T2

      Device name: T2

      Project type: Project

      Project ID: 29DCBA1D-C615-4560-AFB4-94EB9565682C

      Autostart: 0

      [3]

      Project name: T3

      Device name: T3

      Project type: Project

      Project ID: 96FE68D0-5337-4072-A96C-F7C1D7525CAF

      Autostart: 0

  • Das in der Runtime laufende Projekt abrufen:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATiCRuntimeManager.exe -s -c projectlist RUNNING

  • Projektstatus abfragen:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c projectstate 96FE68D0-5337-4072-A96C-F7C1D7525CAF

  • Ein Projekt starten:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c start 96FE68D0-5337-4072-A96C-F7C1D7525CAF

  • Ein Projekt stoppen:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c stop 96FE68D0-5337-4072-A96C-F7C1D7525CAF

  • Ein Projekt aus der Runtime entfernen:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c remove 96FE68D0-5337-4072-A96C-F7C1D7525CAF

  • Beispiel zur Abfrage des Status eines Simulationsprojekts:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin>SIMATICRuntimeManager.exe -s -sim -c projectstate 96FE68D0-5337-4072-A96C-F7C1D7525CAF

  • Passwort für die sichere Kommunikation mit Runtime setzen:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c securemode < password >

  • Autostart für ein Projekt aktivieren:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c setautostart 28AC5BD5-0741-42D1-B3C6-503359F32B7E

  • Autostart für ein Projekt deaktivieren:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c removeautostart 28AC5BD5-0741-42D1-B3C6-503359F32B7E

  • Ein TIA Portal-Archiv vollständig laden:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c fulldownload "C:\Users\admin\Desktop\ HMI_RT_1[Project1] - Full 2019-10-21 - 08.00.22.zip"

  • Nur die Änderungen eines TIA Portal-Archivs laden (Deltaladen):

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -keepUmc -c fulldownload "C:\Users\admin\Desktop\HMI_RT_1[Project1] - Full 2020-03-27 - 11.39.51.zip"

  • UMC-Daten während des vollständigen Ladens beibehalten:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -c deltadownload "C:\Users\admin\Desktop\ HMI_RT_1[Project1] - Delta 2019-10-21 - 08.03.18.zip"

  • UMC-Daten während des vollständigen Ladens ersetzen:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s -overwriteUmc -c fulldownload "C:\Users\admin\Desktop\HMI_RT_1[Project1] - Full 2020-03-27 - 11.39.51.zip"

  • Hilfsmeldungen aktivieren:

    Eingabe:

    C:\Program Files\Siemens\Automation\WinCCUnified\bin> start /wait SIMATICRuntimeManager.exe -s – u