Änderungen von Dokument 4. Windows Install Options

Zuletzt geändert von teamwire001 am 2025/09/11 14:59

Von Version 3.1
bearbeitet von teamwire001
am 2023/11/07 11:39
Änderungskommentar: DOC-248
Auf Version 5.2
bearbeitet von teamwire001
am 2025/09/11 14:59
Änderungskommentar: DOC-434

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,48 +1,54 @@
1 -= Desktop 4.0.0 oder neuer =
1 +{{id name="4-quietinstall"/}}
2 2  
3 += Stille Installation =
3 3  
4 -Microsoft Windows Installer ist ein Installations- und Konfigurationsdienst, der mit Windows bereitgestellt wird. Er ermöglicht unter anderem das Ausführen von Prozessen mit dem Windows-Befehl {{code}}msiexec{{/code}}.
5 +{{tabs idsToLabels="install1=Desktop 4, install2=Bis Desktop 3.4.3"/}}
5 5  
6 -Diesen Befehl können Sie verwenden, um bspw. eine [[stille Installation (Hintergrundinstallation)>>doc:||anchor="4-quietinstall"]] von Teamwire ganz ohne Benutzerinteraktion auszuführen, oder um den [[Installationskontext>>doc:||anchor="4-installcontext"]] zu bestimmen.
7 +(% id="install1" %)
8 +(((
9 +Microsoft Windows Installer ist ein Installations- und Konfigurationsdienst, der mit Windows bereitgestellt wird. Er ermöglicht unter anderem das Ausführen von Prozessen mit dem Windows-Befehl {{code language="none"}}msiexec{{/code}} ganz ohne Benutzerinteraktion.
7 7  
11 +Die **Anzeigeoptionen** der {{code language="none"}}msiexec{{/code}} ermöglichen eine stille Installation. Alle verfügbaren Parameter finden Sie hier: [[Microsoft ~> msiexec ~> Anzeigeoptionen>>url:https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
8 8  
9 -{{id name="4-quietinstall"/}}
10 10  
11 -== Stille Installation ==
12 -
13 -Die **Anzeigeoptionen** der {{code}}msiexec{{/code}} ermöglichen eine stille Installation. Alle verfügbaren Parameter finden Sie hier: [[Microsoft > msiexec > Anzeigeoptionen>>url:https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
14 -
15 -
16 16  Um die Teamwire App still zu installieren, verwenden Sie folgenden Befehl und Parameter:
17 17  
18 -{{code language="shell"}}
16 +{{code language="none"}}
19 19  msiexec.exe /i <path_to_package> /qn
20 20  {{/code}}
21 21  
22 -Beispiel: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
20 +Beispiel: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
21 +)))
23 23  
23 +(% id="install2" %)
24 +(((
25 +Über die Kommandozeile kann eine Hintergrundinstallation von Teamwire ganz ohne Benutzerinteraktion ausgeführt werden.
24 24  
25 -{{id name="4-quietdeinstall"/}}
27 +Die Syntax des Befehls lautet
26 26  
27 -== Stille Deinstallation ==
29 +{{code language="none"}}
30 +start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
31 +{{/code}}
28 28  
29 -Die **Anzeigeoptionen** der {{code}}msiexec{{/code}} ermöglichen eine stille Deinstallation. Alle verfügbaren Parameter finden Sie hier: [[Microsoft > msiexec > Anzeigeoptionen>>url:https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
33 +Geben Sie in diesem Befehl den Pfad zur Teamwire-Installationsdatei an und spezifizieren Sie mit der ##/D## - Option das Verzeichnis, in welchem Sie Teamwire installieren möchten.
30 30  
35 +Beispiel:
31 31  
32 -Um die Teamwire App still zu deinstallieren, verwenden Sie folgenden Befehl und Parameter:
33 -
34 -{{code language="shell"}}
35 -msiexec.exe /x <path_to_package> /qn
37 +{{code language="none"}}
38 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
36 36  {{/code}}
37 37  
38 -Bei der Deinstallation ist der Pfad zur MSI-Datei von Ihrer Datenverwaltung abhängig.
41 +Eine Verknüpfung der Anwendung finden Sie im Teamwire Installationsverzeichnis.
39 39  
43 +Das Ziel der Verknüpfung bei Standardinstallation lautet {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
40 40  
41 -Beispiel A: {{code language="shell"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
42 -Die Datei, die schon für die Installation verwendet wurde, bleibt in einem definierten Verzeichnis bestehen.
45 +{{info}}
46 +Bitte beachten Sie, dass ##/D## **immer als letztes in der Kommandozeile steht** und **der Pfad ohne Anführungszeichen angegeben wird,** auch wenn er Leerzeichen enthält.
47 +{{/info}}
48 +)))
43 43  
44 -Beispiel B: {{code language="shell"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
45 -Sie nutzen die vom System gecachte MSI-Datei. Diese liegt standardmäßig unter ##%SystemRoot%\Installer##.
50 +(% style="border-color:var(--gili_blue_300)" %)
51 +----
46 46  
47 47  
48 48  {{id name="4-installcontext"/}}
... ... @@ -49,18 +49,24 @@
49 49  
50 50  == Installationskontext ==
51 51  
58 +{{tabs idsToLabels="context1=Desktop 4, context2=Bis Desktop 3.4.3"/}}
59 +
60 +(% id="context1" %)
61 +(((
62 +Microsoft Windows Installer ist ein Installations- und Konfigurationsdienst, der mit Windows bereitgestellt wird. Er ermöglicht unter anderem das Ausführen von Prozessen mit dem Windows-Befehl {{code language="none"}}msiexec{{/code}} ganz ohne Benutzerinteraktion.
63 +
52 52  Der Windows Installer kann ein Paket auf einem Computer in zwei Installationskontexten installieren: computerspezifisch und benutzerspezifisch.
53 53  
54 -Eine computerspezifische Installation des Pakets ist erforderlich, **damit alle Benutzer** des Computers auf die Anwendung zugreifen und diese verwenden können. Da eine computerspezifische Installation Änderungen am System vornimmt, die sich auf alle Benutzer auswirken, werden hier Administratorrechte benötigt. Weitere Informationen finden Sie hier: [[Microsoft > Windows Installer > Installationskontext>>https://learn.microsoft.com/de-de/windows/win32/msi/installation-context||rel="noopener noreferrer" target="_blank"]]
66 +Eine computerspezifische Installation des Pakets ist erforderlich, **damit alle Benutzer** des Computers auf die Anwendung zugreifen und diese verwenden können. Da eine computerspezifische Installation Änderungen am System vornimmt, die sich auf alle Benutzer auswirken, werden hier Administratorrechte benötigt. Weitere Informationen finden Sie hier: [[Microsoft ~> Windows Installer ~> Installationskontext>>https://learn.microsoft.com/de-de/windows/win32/msi/installation-context||rel="noopener noreferrer" target="_blank"]]
55 55  
56 56  
57 57  {{id name="4-context-user"/}}
58 58  
59 -=== Benutzerbezogen ===
71 +(% class="numbox" %)A(%%) (% class="numbox-title" %)Benutzerbezogene Installation
60 60  
61 61  Das Paket wird standardmäßig im benutzerbezogenen Installationskontext installiert. Der folgende Befehl führt die benutzerbezogene Installation durch:
62 62  
63 -{{code language="shell"}}
75 +{{code language="none"}}
64 64  msiexec.exe /i <path_to_package>
65 65  {{/code}}
66 66  
... ... @@ -69,11 +69,11 @@
69 69  
70 70  {{id name="4-context-machine"/}}
71 71  
72 -=== Computerbezogen ===
84 +(% class="numbox" %)B(%%) (% class="numbox-title" %)Computerbezogene Installation
73 73  
74 74  Um das Paket im computerbezogenen Installationskontext zu installieren, wird der Parameter ##ALLUSERS## benötigt. Der folgende Befehl führt die computerbezogene Installation durch:
75 75  
76 -{{code language="shell"}}
88 +{{code language="none"}}
77 77  msiexec.exe /i <path_to_package> ALLUSERS=1
78 78  {{/code}}
79 79  
... ... @@ -82,147 +82,136 @@
82 82  
83 83  {{id name="4-context-custom"/}}
84 84  
85 -=== Benutzerdefinierter Installationsverzeichnis ===
97 +(% class="numbox" %)C(%%) (% class="numbox-title" %)Benutzerdefiniertes Installationsverzeichnis
86 86  
87 87  Sie können ein benutzerdefiniertes Verzeichnis für die Installation der Teamwire App mit dem folgenden Parameter definieren:
88 88  
89 -{{code language="shell"}}
101 +{{code language="none"}}
90 90  msiexec.exe /i <path_to_package> APPLICATIONFOLDER=<absolute_application_path>
91 91  {{/code}}
92 92  
93 -Beispiel: {{code language="shell"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
105 +Beispiel: {{code language="none"}}msiexec.exe /i "C:\Users\USERNAME\Downloads\teamwire-setup.msi" APPLICATIONFOLDER="C:\Teamwire"{{/code}}
106 +)))
94 94  
108 +(% id="context2" %)
109 +(((
110 +{{id name="roamingdir"/}}
95 95  
112 +(% class="numbox" %)A(%%) (% class="numbox-title" %)Benutzerdaten im Roaming-Verzeichnis
96 96  
97 -----
114 +{{code language="none"}}/APPDATA=TRUE{{/code}} ## ##
98 98  
99 -{{id name="desktop-previous"/}}
116 +Dies ist ein optionaler Paramenter.
100 100  
101 -= Bis Desktop 3.4.2 =
118 +Standardmäßig werden die Benutzerdaten unter ##%LOCALAPPDATA%## (##..\AppData\Local\##) abgelegt.
102 102  
120 +In manchen Umgebungen oder virtuellen Systemen löschen Richtlinien diese Ordner nach einer Sitzung wieder. Um die Daten in das ##%APPDATA%## Verzeichnis (##..\AppData\Roaming\##) zu schreiben, fügen Sie der Installation das Argument ##/APPDATA=TRUE## hinzu.
103 103  
104 -Über die Kommandozeile kann eine Hintergrundinstallation von Teamwire ganz ohne Benutzerinteraktion ausgeführt werden.
105 -
106 -Die Syntax des Befehls lautet
107 -
108 -{{code language="plain"}}
109 -start "" /WAIT Teamwire-setup_XXX.exe /S [optional parameters] /D=<path>
110 -{{/code}}
111 -
112 -## ##
113 -
114 -Geben Sie in diesem Befehl den Pfad zur Teamwire-Installationsdatei an und spezifizieren Sie mit der ##/D## - Option das Verzeichnis, in welchem Sie Teamwire installieren möchten.
115 -
116 116  Beispiel:
117 117  
118 -{{code language="plain"}}
119 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /D=C:\Program Files (x86)\Teamwire\
124 +{{code language="none"}}
125 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
120 120  {{/code}}
121 121  
122 -## ##
123 -
124 -(% class="box infomessage" %)
125 -(((
126 -Bitte beachten Sie, dass ##/D## **immer als letztes in der Kommandozeile steht** und **der Pfad ohne Anführungszeichen angegeben wird,** auch wenn er Leerzeichen enthält.
127 -)))
128 -
129 -## ##
130 -
131 131  Eine Verknüpfung der Anwendung finden Sie im Teamwire Installationsverzeichnis.
132 132  
133 -Das Ziel der Verknüpfung bei Standardinstallation lautet {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app"{{/code}}
130 +Das Ziel der Verknüpfung inkl. Roaming-Verzeichnis lautet {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire{{/code}}
134 134  
135 135  
136 -{{id name="optional"/}}
133 +{{id name="customdir"/}}
137 137  
138 -== Optionale Parameter ==
135 +(% class="numbox" %)B(%%) (% class="numbox-title" %)Benutzerdaten in benutzerdefiniertem Verzeichnis
139 139  
140 -Die nachfolgenden Parameter sind optional und ermöglichen es diverse Einstellungen direkt bei der Installation vorzunehmen.
137 +{{code language="none"}}/USERDATADIR=<path>{{/code}} ## ##
141 141  
142 -Bitte beachten Sie weiterhin, dass Verzeichnisangabe ##/D## immer als letztes in der Kommandozeile steht und der Pfad ohne Anführungszeichen genannt wird, auch wenn er Leerzeichen enthält.
139 +Dies ist ein optionaler Paramenter.
143 143  
141 +Sollten Sie aufgrund Ihrer Netzwerkumgebung oder Richtlinien zur Aufbewahrung lokaler Daten die Benutzerdaten auf einem anderen Pfad (bspw. einem automatisch gemappten Home-Verzeichnis je Benutzer) ablegen wollen, können Sie diesen über den Parameter ##/USERDATADIR## definieren. **Der Pfad des Parameter muss in Anführungszeichen gesetzt werden.**
144 144  
145 -{{id name="roamingdir"/}}
143 +Die Ordnerstruktur im benutzerdefinierten Verzeichnis wird erst bei Registrierung am Desktop Client erstellt. Beachten Sie außerdem, dass trotz der Definition eines eigenen Benutzerdatenverzeichnis die ursprüngliche Struktur unter ##%LOCALAPPDATA%\Teamwire\User Data\Default\## erstellt wird. Diese enthält jedoch keinerlei Daten.
146 146  
147 -=== Benutzerdaten im Roaming-Verzeichnis ===
148 -
149 -{{code language="plain"}}/APPDATA=TRUE{{/code}} ## ##
150 -
151 -Standardmäßig werden die Benutzerdaten unter ##%LOCALAPPDATA%## (##..\AppData\Local\##) abgelegt.
152 -
153 -In manchen Umgebungen oder virtuellen Systemen löschen Richtlinien diese Ordner nach einer Sitzung wieder. Um die Daten in das ##%APPDATA%## Verzeichnis (##..\AppData\Roaming\##) zu schreiben, fügen Sie der Installation das Argument ##/APPDATA=TRUE## hinzu.
154 -
155 155  Beispiel:
156 156  
157 -{{code language="plain"}}
158 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /APPDATA=TRUE /D=C:\Program Files (x86)\Teamwire\
147 +{{code language="none"}}
148 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
159 159  {{/code}}
160 160  
161 -## ##
162 -
163 163  Eine Verknüpfung der Anwendung finden Sie im Teamwire Installationsverzeichnis.
164 164  
165 -Das Ziel der Verknüpfung inkl. Roaming-Verzeichnis lautet {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir=%APPDATA%/Teamwire{{/code}}
153 +Das Ziel der Verknüpfung inkl. benutzerdefiniertem Verzeichnis lautet {{code language="none"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"{{/code}}
166 166  
167 167  
168 -{{id name="customdir"/}}
156 +{{id name="runonstartup"/}}
169 169  
170 -=== Benutzerdaten in benutzerdefiniertem Verzeichnis ===
158 +(% class="numbox" %)C(%%) (% class="numbox-title" %)Beim Start automatisch ausführen
171 171  
172 -{{code language="plain"}}/USERDATADIR=<path>{{/code}} ## ##
160 +{{code language="none"}}/STARTUP=TRUE{{/code}} ## ##
173 173  
174 -Sollten Sie aufgrund Ihrer Netzwerkumgebung oder Richtlinien zur Aufbewahrung lokaler Daten die Benutzerdaten auf einem anderen Pfad (bspw. einem automatisch gemappten Home-Verzeichnis je Benutzer) ablegen wollen, können Sie diesen über den Parameter ##/USERDATADIR## definieren. **Der Pfad des Parameter muss in Anführungszeichen gesetzt werden.**
162 +Dies ist ein optionaler Paramenter.
175 175  
176 -Die Ordnerstruktur im benutzerdefinierten Verzeichnis wird erst bei Registrierung am Desktop Client erstellt. Beachten Sie außerdem, dass trotz der Definition eines eigenen Benutzerdatenverzeichnis die ursprüngliche Struktur unter ##%LOCALAPPDATA%\Teamwire\User Data\Default\## erstellt wird. Diese enthält jedoch keinerlei Daten.
164 +Mit diesem Parameter aktivieren Sie bereits während der Installation, dass Teamwire zukünftig beim Start von Windows ausgeführt werden soll.
177 177  
178 -Beispiel:
166 +Example:
179 179  
180 -{{code language="plain"}}
181 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program Files (x86)\Teamwire\
168 +{{code language="none"}}
169 +start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
182 182  {{/code}}
171 +)))
183 183  
184 -## ##
173 +(% style="border-color:var(--gili_blue_300)" %)
174 +----
185 185  
186 -Eine Verknüpfung der Anwendung finden Sie im Teamwire Installationsverzeichnis.
187 187  
188 -Das Ziel der Verknüpfung inkl. benutzerdefiniertem Verzeichnis lautet {{code language="plain"}}"<app_directory>\Teamwire\nw.exe" "<app_directory>\Teamwire\app" --user-data-dir="<userdata_directory>\Teamwire"{{/code}}
177 +{{id name="4-quietdeinstall"/}}
189 189  
179 += Stille Deinstallation =
190 190  
191 -{{id name="runonstartup"/}}
181 +{{tabs idsToLabels="deinstall1=Desktop 4, deinstall2=Bis Desktop 3.4.3"/}}
192 192  
193 -=== Beim Start automatisch ausführen ===
183 +(% id="deinstall1" %)
184 +(((
185 +Microsoft Windows Installer ist ein Installations- und Konfigurationsdienst, der mit Windows bereitgestellt wird. Er ermöglicht unter anderem das Ausführen von Prozessen mit dem Windows-Befehl {{code language="none"}}msiexec{{/code}} ganz ohne Benutzerinteraktion.
194 194  
195 -{{code language="plain"}}/STARTUP=TRUE{{/code}} ## ##
187 +Die **Anzeigeoptionen** der {{code language="none"}}msiexec{{/code}} ermöglichen eine stille Deinstallation. Alle verfügbaren Parameter finden Sie hier: [[Microsoft ~> msiexec ~> Anzeigeoptionen>>url:https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#display-options||rel="noopener noreferrer" target="_blank"]]
196 196  
197 -Mit diesem Parameter aktivieren Sie bereits während der Installation, dass Teamwire zukünftig beim Start von Windows ausgeführt werden soll.
198 198  
199 -Example:
190 +Um die Teamwire App still zu deinstallieren, verwenden Sie folgenden Befehl und Parameter:
200 200  
201 -{{code language="plain"}}
202 -start "" /WAIT Teamwire-setup_1.10.0.exe /S /STARTUP=TRUE /D=C:\Program Files (x86)\Teamwire\
192 +{{code language="none"}}
193 +msiexec.exe /x <path_to_package> /qn
203 203  {{/code}}
204 204  
196 +Bei der Deinstallation ist der Pfad zur MSI-Datei von Ihrer Datenverwaltung abhängig.
205 205  
206 -{{id name="silentdeinstall"/}}
207 207  
208 -== Silent Deinstallation ==
199 +**Beispiel A:** {{code language="none"}}msiexec.exe /x "C:\Users\USERNAME\Downloads\teamwire-setup.msi" /qn{{/code}}
200 +Die Datei, die schon für die Installation verwendet wurde, bleibt in einem definierten Verzeichnis bestehen.
209 209  
202 +
203 +**Beispiel B:** {{code language="none"}}msiexec.exe /x "C:\Windows\Installer\34237a6a.msi" /qn{{/code}}
204 +Sie nutzen die vom System gecachte MSI-Datei. Diese liegt standardmäßig unter ##%SystemRoot%\Installer##.
205 +)))
206 +
207 +(% id="deinstall2" %)
208 +(((
210 210  Teamwire kann über die Kommandozeile im Hintergrund deinstalliert werden.
211 211  
212 212  Die Syntax des Befehls lautet
213 213  
214 -{{code language="plain"}}
213 +{{code language="none"}}
215 215  start "" /WAIT "<path>\uninstall.exe" /S
216 216  {{/code}}
217 217  
218 218  Geben Sie in diesem Befehl den Pfad zur Deinstallationsdatei an. Diese liegt im Hauptverzeichnis der Teamwire Anwendung. **Der Pfad der Deinstallationsdatei muss in Anführungszeichen gesetzt werden.**
219 219  
220 -Beispiel: {{code language="plain"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
219 +Beispiel: {{code language="none"}}start "" /WAIT "C:\Program Files (x86)\Teamwire\uninstall.exe" /S{{/code}}
221 221  
222 -
223 -(% class="box infomessage" %)
224 -(((
221 +{{info}}
225 225  Die Entfernung der Benutzerdaten findet nur für den Benutzer statt, welcher die lokale Deinstallation ausführt.
223 +{{/info}}
226 226  )))
227 227  
226 +(% style="border-color:var(--gili_blue_300)" %)
227 +----
228 +
228 228  ## ##