Kommandozeilen-Parameter

/adressenexport

Startet den Adressenexport ins Outlook. Dieser Parameter wird nur für die Batchbenutzung verwendet.

/adressenimport

Startet den Adressenimport aus dem Outlook. Dieser Parameter wird nur für die Batchbenutzung verwendet.

/batch

Der Vertec-Prozess wird gestartet, aber das Programm erscheint nicht auf der Oberfläche. Wird vor allem beim Scheduling gebraucht.

/batch_nologin

Ab Version 6.1.0.12. startet Vertec im Batch Modus und beendet die Applikation vor dem Login wieder. Die Angabe von /batch_nologin bewirkt folgendes:

• Vertec.Desktop startet im Batch-Modus (siehe auch Parameter /batch)
• Allfällige Fehler werden auf Commandline angezeigt, %errorlevel% ist dann 1 statt 0
• Die Applikation wird vor dem Login beendet.
• Wenn die Vertec Version geändert hat, wird Defaultdata durchlaufen (siehe auch Parameter /DD)

Wird von Vertec verwendet für das Update der Cloud Abos nach einem Versionswechsel.

Ist nur sinnvoll für die Ausführung von Defaultdata und kann nicht mit anderen Parametern wie /script kombiniert werden, da Vertec vor dem Start wieder geschlossen wird.

/bmrecalc

Nur Vertec Versionen vor 6.4. starten den Berechnungsvorgang für das Benchmarking Modul.

Für die Berechnung der Daten für das Business Intelligence Modul, welches ab Vertec 6.4 zur Verfügung steht, siehe den Artikel über die BI Generatoren.

/culture

Die Ländereinstellung des Clients ändern (Zahlen- und Datumsformat).
Codes gemäss https://docs.microsoft.com/en-us/previous-versions/commerce-server/ee825488(v=cs.20)

Vertec.Cloud.exe /culture:en-US

/DB Datenbank

Name des Abschnitts der Vertec.ini-Datei, der die Schlüssel zu einer bestimmten Datenbank enthält. Damit kann eine andere als die Standard-Datenbank gestartet werden.

/DC

Startet statt Vertec den Datenbankkonverter. Siehe dazu auch den Artikel über den Update von Vertec.

/DD

Führt beim Start von Vertec eine Standarddaten Kontrolle durch. Normalerweise erfolgt ein solcher Kontrolldurchgang automatisch, wenn Vertec mit einer neuen Programmversion gestartet wird.

Ab Vertec 6.6.0.6. Mit diesem Parameter kann eine neue, leere Vertec Datenbank generiert und am mittels Path angegebenen Pfad abgelegt werden.

Der Vertec Setup generiert die leere Datenbank bei On-Premises Neuinstallationen auf diese Weise.

/NODD

Defaultdata überspringen, auch wenn es aufgrund eines Versionssprungs eigentlich durchlaufen würde. Nicht empfehlenswert.

/noevents

Eventscripts deaktivieren. Kann für Debugging von Eventscripts nützlich sein.

Das Starten der Desktop App mit dem /noevents Parameter ist nur für Debugging und Daten-Migrationen gedacht und kann im produktiven Betrieb zu inkonsistenten Daten führen. Deshalb ist dieser Parameter ab Vertec 6.2 nur noch bei Benutzern mit Administratorrechten wirksam.

Um zu überprüfen, ob der eingeloggte Benutzer Administrator ist, kann /noevents erst nach dem Login ausgewertet werden. Das bedeutet, dass Eventscripts vom Typ Login immer ausgeführt werden.

/passwort

Angabe des zum Login passenden Passwortes. Wird vor allem beim Scheduling gebraucht. Kann auch für automatisches Login verwendet werden.

/paysync

Um den Zahlungsabgleich zu automatisieren, also zum Beispiel via Batch-File über Nacht laufen zu lassen, kann die Desktop App mit dem Parameter /paysync gestartet werden.

/pythonedit

Aktiviert den Menüpunkt für den Python Script Editor. Nur Versionen vor Vertec 5.8. Ab Vertec 5.8 ist der Python Script Editor fix im Menü Einstellungen (Desktop App und Cloud App) zu finden.

/regserver

Der Vertec COM Server wird beim Desktop App Setup von Vertec automatisch registriert (benötigt Admin- bzw. Elevated-Rechte). Für die manuelle Registrierung, z.B. zur Fehlerbehebung oder bei einer Installation durch eine Softwareverteilung, kann Vertec.Desktop.exe mit diesem Parameter aufgerufen werden.

/releaseupgradelock

Wird eine Datenbank konvertiert, oder wird vom System ein Versionswechsel festgestellt, so dass die Desktop App gewisse Dinge anpassen muss, ist sie während dieser Zeit für den Zugriff gesperrt. Tritt nun während dieses Prozesses ein Fehler auf, kann es sein, dass diese Sperre, der sogenannte Upgrade-Lock, bestehen bleibt. Es erscheint dann immer folgende Meldung:

Um diese Sperre zurückzusetzen, können Sie Vertec mit dem Parameter /releaseupgradelock starten. Dieser setzt den Upgrade-Lock auf der Datenbank zurück und beendet Vertec gleich wieder.

/script <script>

Ruft ein Script in Vertec auf. Der Parameter gibt den Namen des Scripts an, welcher der Bezeichnung des in Vertec registrierten Scripts entspricht. Falls mehrere /script Argumente vorhanden sind, werden diese nacheinander ausgeführt. Es werden nur registrierte Scripts und ab Version 6.1.0.11 auch Python Scripts, welche auf dem Filesystem liegen (mit Endung .py), unterstützt. In diesem Fall muss als Parameter der Dateipfad übergeben werden.

/setlicense <liccode> <licname> <licdbcode>

Ab Version 6.1.0.10 in Vertec Desktop. Erlaubt das Setzen eines Lizenzcodes. Es gelten folgende Regeln:

• Die Parameter Licname und Licdbcode sind bei bestehenden DBs optional.
• Der Lic-DBCode kann nur bei "neuen" DBs gesetzt werden und wird nur Vertec intern gebraucht.
• Falls die angegebenen Lizenzangaben ungültig sind, wird ein Fehler gemeldet und es werden keine Änderungen vorgenommen.
• Der Fehler wird in Batch-mode auf Commandline angezeigt, %errorlevel% ist dann 1 statt 0.
• Die Applikation wird vor dem Login beendet.

/setpassword <benutzer> <password>

Ab Version 6.1.0.11 in Vertec.Desktop. Erlaubt das Setzen des Passworts eines Users. Es gelten folgende Regeln:

• Der User muss aktiv sein
• Es darf noch kein Passwort gesetzt sein. Falls das Passwort nicht leer ist, wird ein Fehler gemeldet
• Der Fehler wird in Batch-mode auf Commandline angezeigt, %errorlevel% ist dann 1 statt 0.
• Die Applikation wird vor dem Login beendet

/silentdbconvert

Ab Version 6.2.0.5. Startet die Datenbank-Konvertierung auf der Desktop App ohne Windows Dialoge für die Ausführung als Commandline Aufruf.

Unterstützt nur Firebird Datenbanken.

• Startet den Convert und gibt den Fortschritt über stdout aus.
• Falls es sich nicht um eine Firebird Datenbank handelt oder keine Filezugriff auf die Datenbank möglich ist, wird ein Fehler gemeldet. Ebenfalls über stdout gemeldet, Return-code <> 0.

/super

Um die Desktop App im SUPER Modus auszuführen, muss sie mit dem Parameter /super aufgestartet werden und der angemeldete Benutzer muss zusätzlich über das Super-Recht (rtSuper) verfügen.

Der SUPER Modus hat folgende Auswirkungen:

• Erlaubt SystemContext in Scripts im interaktiven Modus (sonst nur für registrierte Scripts mit erweiterten Rechten).
• Erlaubt Verwendung von Rechnung.SetTotal Methode (COM). Dient zum Setzen von Rechnungstotalen auf verrechneten Rechnungen (wird in Migrationen verwendet).
• Überspringt beim Löschen von Objekten die kaskadierte Prüfung von Löschrechten. Es wird nur das Löschrecht auf dem ursprünglichen Objekt geprüft.
• Allgemeine Rechteprüfung: verhindert Effekt von finalen Rechten, das heisst, der SUPER Modus darf alles, auch Dinge, die von Businesslogik her sonst verboten sind.

Bei der Verwendung von Vertec im SUPER Modus ist Vorsicht geboten. Durch die weitreichenden Möglichkeiten kann man Vertec in einen inkonsistenten, nicht mehr lauffähigen Zustand bringen.

/unregserver

Entfernt die Registrierung des Vertec COM Servers.

/username

Angabe des Logins. Wird vor allem beim Scheduling gebraucht. Kann auch für ein automatisches Login verwendet werden.

/batch

Ab Version 6.5.0.22

Der Vertec-Prozess wird gestartet, aber das Programm erscheint nicht auf der Oberfläche. Die Authentisierung erfolgt entweder über /username + /password oder über den Loginscreen.

/culture

Die Ländereinstellung des Clients ändern (Zahlen- und Datumsformat).
Codes gemäss https://docs.microsoft.com/en-us/previous-versions/commerce-server/ee825488(v=cs.20)

Vertec.Cloud.exe /culture:en-US

/noevents

Ab Version 6.5.0.22. (nur als Administrator)

Deaktiviert das Eventscript System für die aktuelle Session. Diese Option ist nützlich für das Debugging von Problemen, die durch Eventscripts verursacht werden.

/noupdate

Unterdrückt das automatische Update (siehe Einstellung AutoUpdate im Vertec.ini File).

Vertec.Cloud.exe /noupdate

/paysync

Ab Version 6.5.0.22

Um den Zahlungsabgleich zu automatisieren, also zum Beispiel via Batch-File über Nacht laufen zu lassen, kann die Cloud App mit dem Parameter /paysync gestartet werden.

/regserver

Der Vertec COM Server wird mit dem Cloud App Installer von Vertec automatisch registriert (falls von den Berechtigungen her möglich und wenn der Installer ausgewählt wurde). Für die manuelle Registrierung, z.B. zur Fehlerbehebung oder bei einer Installation durch eine Softwareverteilung, kann Vertec.Cloud.exe mit diesem Parameter aufgerufen werden. (nur als Administrator)

Vertec.Cloud.exe /regserver

/script <scriptname>

Ab Version 6.5.0.22

Führt nach dem Starten den via Namen angegebenen Scripteintrag oder die angegebene Script-Datei aus. Die Session bleibt anschliessend gestartet, die Cloud App kann normal weiterverwendet werden.

/server

Verbindet die Cloud App mit dem angegebenen Server

Vertec.Cloud.exe /server http://localhost:8081/

/super

Ab Version 6.5.0.22. (nur als Administrator)

Um die Cloud App im SUPER Modus auszuführen, muss sie mit dem Parameter /super aufgestartet werden und der angemeldete Benutzer muss zusätzlich über das Super-Recht (rtSuper) verfügen.

Der SUPER Modus hat folgende Auswirkungen:

• Erlaubt SystemContext in Scripts im interaktiven Modus (sonst nur für registrierte Scripts mit erweiterten Rechten).
• Erlaubt Verwendung von Rechnung.SetTotal Methode (COM). Dient zum Setzen von Rechnungstotalen auf verrechneten Rechnungen (wird in Migrationen verwendet).
• Überspringt beim Löschen von Objekten die kaskadierte Prüfung von Löschrechten. Es wird nur das Löschrecht auf dem ursprünglichen Objekt geprüft.
• Allgemeine Rechteprüfung: verhindert Effekt von finalen Rechten, das heisst, der SUPER Modus darf alles, auch Dinge, die von Businesslogik her sonst verboten sind.

Bei der Verwendung von Vertec im SUPER Modus ist Vorsicht geboten. Durch die weitreichenden Möglichkeiten kann man Vertec in einen inkonsistenten, nicht mehr lauffähigen Zustand bringen.

/unregserver

Unregistriert den COM Server (Typelibrary)

Vertec.Cloud.exe /unregserver

(als Administrator)

Vertec URL

URL des Objekts, mit dem Vertec gestartet werden soll.

Vertec.Cloud.exe vertec://Christoph+Keller-676/eigene+Projekte-49/

/install

Lädt Vertec.Cloud herunter und speichert es mitsamt der Konfigurationsdatei im aktuellen Verzeichnis, in dem sich der Cloud Installer befindet (ohne optionale Komponenten).

• Der Servername, von wo Vertec.Cloud heruntergeladen wird (Ihre Vertec-Domain), wird mit dem Parameter /server angegeben oder im Filenamen encodiert (siehe Beispiele).
• Ein alternatives Verzeichnis kann ab Version 6.5.0.20 mit dem Parameter /dir angegeben werden.

Beispiele:

• Vertec.CloudInstaller.exe /install /server=https://domain.com  lädt Vertec.Cloud vom Server, der mit /server angegeben wurde.
• Vertec.CloudInstaller_https_domain.com_port.exe /install lädt Vertec.Cloud vom Server, der in der URL codiert ist.
• Vertec.CloudInstaller_https_domain.com_port.exe entspricht dem Download-File. Dieses kann ohne Parameter irgendwo gestartet werden. Der Download von Vertec.Cloud erfolgt vom Server, der im Filename encodiert ist. Es erfolgt die Standardinstallation in %appdatalocal%/Vertec Cloud App.

Gleich wie /install, aber mit optionalen Komponenten.

Ab Vertec 6.5.0.20. Gibt einen alternativen Ordner für die Installation an. Falls das Verzeichnis noch nicht existiert, wird versucht, dieses anzulegen.

Vertec.CloudInstaller.exe /install /dir=<mein Verzeichnis>

/uninstall

Deinstalliert die Cloud App. Dies ist eine Alternative zur Deinstallation über "Programme hinzufügen oder entfernen".

Vertec.CloudInstaller.exe /uninstall

/update

Wird analog zu /install verwendet und aktualisiert die Cloud App.

Hinweis: Die Datei Vertec.CloudInstaller.exe muss aktuell sein, diese wird nur im Auto Update Fall automatisch neu vom Server geholt.

Vertec.CloudInstaller.exe /update /server=https://domain.com

Angabe der entsprechenden Domain. Alternativ kann der Servername auch im Installername encodiert sein, dann entfällt der Parameter /server. (siehe Parameter bzw. /update).

Ab Vertec 6.5.0.20. Wird der Cloud Installer mit /silent gestartet, werden keine Benutzeroberfläche bzw. keine Dialoge angezeigt.

Im Fehlerfall (Schreibrechte, Admin-Rechte für Runtime Installation, Zielverzeichnis nicht schreibbar etc.) ist der Rückgabewert != 0. In der Konsole wird die Fehlermeldung ausgegeben. 

/install

Installiert die Windows Edition der Outlook App lokal. Der Servername, von wo die Outlook App heruntergeladen wird (Ihre Vertec-Domain), wird mit dem Parameter /server angegeben oder im Filenamen encodiert.

Beispiele:

• Vertec.OutlookInstaller.exe /install /server=https://domain.com lädt die Outlook App Windows Edition vom Server, der mit /server angegeben wurde.
• Vertec.OutlookInstaller_https_domain.com_80.exe /install lädt Outlook App Windows Edition vom Server, der in der URL codiert ist.

/uninstall

Deinstalliert die Outlook App lokal.

Vertec.OutlookInstaller.exe /uninstall

/update

Aktualisiert die Outlook App Windows Edition.

Hinweis: Die Datei Vertec.OutlookInstaller.exe muss aktuell sein.

Vertec.OutlookInstaller.exe /update /server=https://domain.com

/noservice

Startet den CloudServer als Executable (kein Service)

Vertec.CloudServer.exe /noservice (als Administrator oder port binding)

/install
[Service Name]
[Service Anzeigename]

Installiert den Vertec Cloud Service. Der Befehl kann komplett ohne Parameter ausgeführt werden. Der Service Name muss jedoch einmalig sein. Der Service Anzeigename ist Optional.

Jeder Service braucht eine eigene Installation mit eigener Konfiguration (Vertec.ini). Wichtige Einstellungen sind dabei Server Port, Secure Server Port und Management Port - diese dürfen sich nicht überschneiden. Siehe dazu auch den Artikel über Mehrere Cloud Server Instanzen.

Vertec.CloudServer.exe /install Vertec.CloudServer2 (als Administrator)

/uninstall
[Service Name]

Deinstalliert den Vertec Cloud Service. Der Parameter ist optional (muss mit dem installierten Namen übereinstimmen).

Vertec.CloudServer.exe /uninstall (als Administrator)

/start
[Service Name]

Startet den Vertec Cloud Service. Der Parameter ist optional (muss mit dem installierten Namen übereinstimmen).

Vertec.CloudServer.exe /start (als Administrator)

/stop
[Service Name]

Stoppt den Vertec Cloud Service. Der Parameter ist optional (muss mit dem installierten Namen übereinstimmen).

Vertec.CloudServer.exe /stop (als Administrator)

/certcreate

Erstellt ein Self-Signed Certificate und registriert dieses im (Local-Machine) Zertifikats-Store (siehe Cloud Server).

Vertec.CloudServer.exe /certcreate (als Administrator)

/csrcreate

Öffnet ein Command Prompt mit den Einstellungen und erstellt einen Certificate Signing Request.

Vertec.CloudServer.exe /csrcreate (als Administrator)

/certbind

Wird nur benötigt, falls der Vertec.CloudServer nicht mit Administrator-Rechten betrieben wird oder einen Binding Fehler ausgelöst hat.

Bindet einmalig das angegebene Zertifikat an einen Endpunkt (Port).

Der Befehl benötigt folgende Einstellungen in der Konfigurationsdatei Vertec.ini:

• Certificate Name (Lesezugriff)
• Secure Server Port (Lesezugriff)
• Trusted Certificate (Schreibzugriff)

Vertec.CloudServer.exe /certbind (als Administrator)

/certunbind

Entfernt einmalig das Binding des Zertifikates vom Endpunkt (Port).

Der Befehl benötigt die Einstellung Secure Server Port in der Konfigurationsdatei Vertec.ini.

Vertec.CloudServer.exe /certunbind (als Administrator)

/status
[Service Name]

Zeigt den Status des Services an. Der Parameter ist optional (muss mit dem installierten Namen übereinstimmen).

Vertec.CloudServer.exe /status

/help
[Service Name]

Zeigt die Hilfe an. Der Parameter ist optional (muss mit dem installierten Namen übereinstimmen).

Vertec.CloudServer.exe /help