Kommandozeilen-Parameter

/adressenexport

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

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

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

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.

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.

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

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.

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

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

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

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

Das Starten von Vertec 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.

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

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

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.

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.

Wird eine Datenbank konvertiert, ist sie während dieser Zeit für den Zugriff gesperrt. Tritt nun während des Konverts 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.

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.

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.

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

Nach der Installation / Deinstallation eines Dienstes erscheint eine Meldung, dass der Service erfolgreich installiert / deinstalliert wurde. Um diese zu unterdrücken, können Sie die Installation / Deinstallation mit dem Parameter /silent durchführen. Beispiel:

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 denFortschritt ü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.

Im Fehlerfall erscheint ein Fehlerdialog. Möchte man auch diesen nicht anzeigen, kann man zusätzlich den Kommandozeilenschalter /batch verwenden:

Um Vertec im SUPER Modus auszuführen, muss 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.

Entfernt die Registrierung des Vertec COM Servers.

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

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

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

Vertec.Cloud.exe /noupdate

/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.

Vertec.Cloud.exe /regserver (als Administrator)

Verbindet die Cloud App mit dem angegebenen Server

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

/unregserver

Unregistriert den COM Server (Typelibrary)

Vertec.Cloud.exe /unregserver (als Administrator)

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 Verzeichnis, in dem er sich befindet.
Alternativ kann der Servername auch im Filenamen encodiert sein, dann entfällt der Parameter /server .

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 Donwload-File. Hier spielt es keine Rolle, wo das File ausgeführt wird. Es erfolgt die Standardinstallation in %appdatalocal%/Vertec Cloud App . Der Download erfolgt vom Server, der im Filename encodiert ist.

/uninstall

Deinstalliert die Cloud App in diesem Ordner. Dies ist eine Alternative zur Deinstallation über Programme.

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

/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 Settings sind dabei Server Port, Secure Server Port und Management Port - diese dürfen sich nicht überschneiden. Siehe dazu auch den Artikel über Mehrere Vertec Services in der Online Knowledge Base.

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