Allgemein
Der TransferClient kann automatisiert installiert werden, indem der Befehl msiexec in der Windows-Eingabeaufforderung oder PowerShell verwendet wird. Dabei müssen korrekte Parameter gesetzt werden. Ein minimaler Aufruf sieht wie folgt aus:
msiexec.exe /i TransferClient.msi /qn
Dabei sorgt der Parameter /qn dafür, das jegliche UI-Elemente und Rückfragen unterdrückt werden.
Parameter für die Installation
Installationsparameter die üblicherweise über die Oberfläche gesetzt werden, können auch beim Aufruf von msiexec angehangen werden. Die Syntax ist dabei PARAMETERNAME=wert. Folgende Parameter können angegeben werden:
| Parametername | Beschreibung | Standardwert (wenn nicht angegeben) |
|---|---|---|
| ERICSERVICENAME | Name des Dienstes unter dem der TransferClient läuft | EricService[1] |
| ERICSERVICEDISPLAYNAME | Anzeigename des Dienstes in der Diensteübersicht | TransferClient ERiC[1] |
| ERICSERVICEENDPOINTURI | Adresse des Endpunktes unter dem der TransferClient erreichbar ist | http://localhost:7777/eric[1] |
| ERICSTARTSERVICE | Gibt an, ob der Dienst nach der Installation gestartet werden soll. Mögliche Werte sind `True` oder `False` | `True` |
| VATIDCHECKSERVICENAME | Name des Dienstes unter dem der VAT-ID-Check Service läuft | VatIdCheckService |
| VATIDCHECKSERVICEDISPLAYNAME | Anzeigename des Dienstes in der Diensteübersicht | TransferClient VAT-ID Check |
| VATIDCHECKSERVICEENDPOINTURI | Adresse des Endpunktes unter dem der VAT-ID-Check erreichbar ist | http://localhost:7777/vatidcheck |
| STARTVATIDCHECKSERVICE | Gibt an, ob der Dienst nach der Installation gestartet werden soll. Mögliche Werte sind `True` oder `False` | `True` |
| USEHTTPS | Gibt an, ob HTTPS[2](#footnote2) für die Verwendung der Dienste verwendet werden soll. Mögliche Werte sind `True` oder `False` | `False` |
1 Dem Standardwert wird die aktuelle Hauptversionsnummer des TransferClients angehangen.
2 Die Verwendung von SSL/TLS erfordert, dass in HTTP.sys ein gültiges Zertifikat für die entsprechenen Endpunkte hinterlegt ist. Verwenden Sie dazu zum Beispiel den Befehl netsh add sslcert in der Eingabeaufforderung. Ergänzen Sie die fehlenden Parameter.
Die Parameter dürfen nicht in Anführungszeichen geschrieben werden.
Beispiel Continuous Deployment
Das Batch-Skript tc-silent-install.bat stellt ein Beispiel für eine Continuous Deployment Möglichkeit dar.
Aufbau
- Setzen der notwendigen Paramater zu Beginn des Skripts
- Setzen von Benutzeranmeldedaten auf die der Service später konfiguriert wird. Die Dienste laufen im Standard unter dem System-Konto
- Aufruf von
msiexec - Konfigurieren der Anmeldedaten der Dienste mittels
sc config - Starten der Dienste (Die Dienste wurden bewusst nicht nach der Installation gestartet, da die geänderten Anmeldedaten erst nach einem Neustart zur Anwendung kommen)
Deinstallation
Das Batch-Skript geht davon aus, dass das Produkt zum Aufrufzeitpunkt nicht installiert ist. Streng genommen müsste zu Beginn ein Aufruf von msiexec /x {product code} erfolgen. Das Problem ist allerdings, dass sich der Produktcode mit jeder Hauptversion ändert, damit eine parallele Installation von mehreren Hauptversionen möglich ist. Der product code kann mit wmic product where "Name like '%TransferClient%'" get Name, Version, IdentifyingNumber abgefragt werden.