Zum Inhalt springen

Änderungen von Dokument Eigene Autoconf-Rolle erstellen

Zuletzt geändert von Tom Altenbrunn am 2023/03/17 08:03
Von Version 37.2
bearbeitet von Tom Altenbrunn
am 2023/03/16 10:49
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 46.1
bearbeitet von Jonas Mayer
am 2023/03/16 12:57
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.TomAltenbrunn@sbede
1 +XWiki.jonasmayer@sbede
Inhalt
... ... @@ -28,7 +28,7 @@
28 28  
29 29  Für die Funktionalität der Autoconf-Rolle ist es also nötig, PowerShell-Skripte am Server abzuspeichern, die die Instruktionen an den Arbeitsstationen ausführen. Für diese Skripte sind folgende Dateinamen zulässig:
30 30  
31 -* **main.ps1** - Skript wird in allen Phasen ausgeführt, die innerhalb der Beschreibungsdatei (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container">meta/logodidact.yml{{box}}meta/logodidact.yml{{/box}}(%%) festgelegt sind
31 +* **main.ps1** - Skript wird in allen Phasen ausgeführt, die innerhalb der Beschreibungsdatei (% data-xwiki-non-generated-content="java.util.List" %){{box}}meta/logodidact.yml{{/box}}(%%) festgelegt sind. Eine solche Datei folgt dem Prinzip „in jeder Phase soll genau das gleiche stattfinden“.
32 32  * (% style="color:#8e44ad" %)**setup.ps1**(%%) - Skript wird ausschließlich in der SETUP-Phase während des Deployments ausgeführt. In der Setup-Phase ist der Client noch veränderlich und besitzt noch keine Schutzfunktion, selbst wenn der Schutz aktiviert ist.
33 33  * (% style="color:#8e44ad" %)**custom.ps1**(%%) - Skript wird ausschließlich in der CUSTOM-Phase ausgeführt. Dies geschieht sowohl 1x während des Deployments als auch später nach jedem Hochfahren des PCs 1x im Hintergrund.
34 34  * (% style="color:#8e44ad" %)**user.ps1**(%%) - Skript wird ausschließlich in der USER-Phase ausgeführt. Diese Phase wird nicht direkt während des Deployments durchlaufen, sondern erst später während der Benutzeranmeldung an betriebsbereiten PCs.
... ... @@ -291,63 +291,64 @@
291 291  
292 292  ----
293 293  
294 -= (% style="font-size:22px" %)__**Weiteres Beispiel: eigene AutoConf-Rolle zur "Deaktivierung der Suchhervorhebung in Windows"**__(%%) =
295 295  
295 +
296 += (% style="font-size:22px" %)__**Weiteres Beispiel: eigene AutoConf-Rolle zur „Deaktivierung der Suchhervorhebung in Windows“**__(%%) =
297 +
296 296  Im nachfolgenden Beispiel wird eine einfache Rolle zur Deaktivierung der Suchvorhebung in Windows deklariert.
297 297  \\[[image:image-20230316103442-2.png||height="530" width="1142" class="img-thumbnail"]]
298 298  
299 -(((
300 300  ----
301 301  
302 -== (% style="font-size:16px" %)**Aufbau der Logodidact.yml:**(%%) ==
303 +== (% style="font-size:16px" %)**Aufbau der logodidact.yml**(%%) ==
303 303  
304 -Neben den allgemeinen Informationen über die Autoren (authors), Unternehmen (company), einer Beschreibung (description), dem Anzeigenamen (display_name) im LD Control Center, usw, beginnt im Abschnitt {{code language="bash"}}vars{{/code}} die eigentliche Definition der Variable
305 -"**{{code language="bash"}}disableSearchHighlight{{/code}}**".
306 -
305 +Neben den allgemeinen Informationen über die Autoren (authors), Unternehmen (company), einer Beschreibung (description), dem Anzeigenamen (display_name) im LD Control Center, usw, beginnt im Abschnitt {{code language="bash"}}vars{{/code}} die eigentliche Definition der Variable
306 +"**{{code}}disableSearchHighlight{{/code}}**".
307 307  
308 +
308 308  {{code language="yaml" width="45%"}}
309 309  #logodidact.yml
310 310  
311 311  ld_info:
312 - authors:
313 + authors:
313 313   - Olav Krapp
314 314   - Marcel Petersen
315 315   - Kerim Ekin
316 - company: SBE network solutions GmbH
317 - description: | #Beschreibung
318 - Die Suchhervorhebung in der Windows Suchleiste wird deaktiviert
319 - display_name: Windows Suchhervorhebung #Anzeigename im LD Control Center
320 - license: SBE
321 - uuid: fec4ff30-b2a6-407f-a6b3-0a621cd7eaf7 #einmalige UUID
322 - vars: #Deklaration der Variablen
323 - disableSearchHighlight: #Name der Variable
324 - display_name: Suchhervorhebung im Suchfeld deaktivieren #Anzeigename im LD Control Center
325 - optional: true #Auswahl optional
326 - type: BOOLEAN #Variablentyp Boolean = True/False
327 - value: false #Standardwert false
328 - visible: true #Sichtbarkeit der Variable im LD Control Center
329 - priority: 0 #Abarbeitungspriorität
330 - applyAlways: false #Rolle immer ausführen oder einmalig
331 - tags:
317 + company: SBE network solutions GmbH
318 + description: | #Beschreibung
319 + Die Suchhervorhebung in der Windows Suchleiste wird deaktiviert
320 + display_name: Windows Suchhervorhebung #Anzeigename im LD Control Center
321 + license: SBE
322 + uuid: fec4ff30-b2a6-407f-a6b3-0a621cd7eaf7 #einmalige UUID
323 + vars: #Deklaration der Variablen
324 + disableSearchHighlight: #Name der Variable
325 + display_name: Suchhervorhebung im Suchfeld deaktivieren #Anzeigename im LD Control Center
326 + optional: true #Auswahl optional
327 + type: BOOLEAN #Variablentyp Boolean = True/False
328 + value: false #Standardwert false
329 + visible: true #Sichtbarkeit der Variable im LD Control Center
330 + priority: 0 #Abarbeitungspriorität
331 + applyAlways: false #Rolle immer ausführen oder einmalig
332 + tags:
332 332   - CUSTOM #Ausführungszeitpunkt während der/den Phase(n)
333 - systems:
334 + systems:
334 334   - WINDOWS #Betriebssystem
335 335  {{/code}}
336 336  
337 -== ==
338 -
339 339  ----
340 340  
341 -== (% style="font-size:16px" %)**Aufbau der main.ps1:**(%%) ==
340 +== (% style="font-size:16px" %)**Aufbau der main.ps1**(%%) ==
342 342  
343 -Danach erfolgt die Erstellung des ausführbaren Codes per Powershell. Im ersten Abschnitt (% style="color:#008000" %)**Param** (%%)werden die in der im vorigen Abschnitt definierten Variaben  {{code language="bash"}}vars{{/code}} aus der logodidact.yml aufgeführt und definiert. Bei der Variable "**{{code}}disableSearchHighlight{{/code}}**" handelt es sich um ein Boolean (True/False). Die Bedingung "**[parameter(Mandatory=$false)]**" setzt das Vorhandensein der Variable während dem Ablauf des Skriptes nicht als zwingend notwendig voraus, sodass bei einem darauffolgenden Verarbeitungsfehler o.ä. die Abarbeitung weiter erfolgt.
344 -\\{{code language="powershell"}}#main.ps1
342 +Danach erfolgt die Erstellung des ausführbaren Codes per Powershell. Im ersten Abschnitt (% style="color:#008000" %)**Param** (%%)werden die in der im vorigen Abschnitt definierten Variablen {{code}}vars{{/code}} aus der logodidact.yml aufgeführt und definiert. Bei der Variable "**{{code}}disableSearchHighlight{{/code}}**" handelt es sich um ein Boolean (True/False). Die Bedingung "**[parameter(Mandatory=$false)]**" setzt das Vorhandensein der Variable während dem Ablauf des Skriptes nicht als zwingend notwendig voraus, sodass bei einem darauffolgenden Verarbeitungsfehler o.ä. die Abarbeitung weiter erfolgt.
345 345  
344 +{{code language="powershell"}}
345 +#main.ps1
346 +
346 346  Param
347 347  (
348 348   [parameter(Mandatory=$false)] #Variable zwingend erforderlich?
349 - [bool] #Variablentyp
350 - $disableSearchHighlight #Name der def. Variable aus logodidact.yml
350 + [bool] #Variablentyp
351 + $disableSearchHighlight #Name der def. Variable aus logodidact.yml
351 351  )
352 352  
353 353  $SystemVersion=[System.Environment]::OSVersion.Version #Hole Windows Systemversion
... ... @@ -354,23 +354,23 @@
354 354  
355 355  #Beginn des eigentlichen Codes
356 356  if ($SystemVersion.Major -eq 10 -and $SystemVersion.Build -ge 19044) {
357 - $val = [int]!$disableSearchHighlight
358 - Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
359 - [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
358 + $val = [int]!$disableSearchHighlight
359 + Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
360 + [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
360 360  } else {
361 - Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
362 -}{{/code}}
362 + Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
363 +}
364 +{{/code}}
363 363  
364 364  ----
365 365  
366 -== (% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server:**(%%) ==
368 +== (% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server**(%%) ==
367 367  
368 -[[image:image-20230316103224-1.png||height="128" width="1226" class="img-thumbnail"]]
370 +[[image:image-20230316110425-1.png||height="124" width="1186" class="img-thumbnail"]]
369 369  
370 -----
371 371  
372 -== (% style="font-size:16px" %)**Ansicht im LD Control Center:**(%%) ==
373 +== (% style="font-size:16px" %)**Ansicht im LD Control Center**(%%) ==
373 373  
374 -(% class="wikigeneratedid" %)
375 - [[image:image-20230316095106-2.png||class="img-thumbnail"]]
376 -)))
375 +[[image:image-20230316110525-2.png||class="img-thumbnail"]]
376 +
377 +
image-20230316110425-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,0 +1,1 @@
1 +166.3 KB
Inhalt
image-20230316110525-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,0 +1,1 @@
1 +48.3 KB
Inhalt