Änderungen von Dokument Eigene Autoconf-Rolle erstellen

Zuletzt geändert von Tom Altenbrunn am 2023/03/17 08:03

Von Version 28.1
bearbeitet von Jonas Mayer
am 2023/03/16 07:55
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 29.3
bearbeitet von Tom Altenbrunn
am 2023/03/16 10:26
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.jonasmayer@sbede
1 +XWiki.TomAltenbrunn@sbede
Inhalt
... ... @@ -96,7 +96,7 @@
96 96  ----
97 97  
98 98  
99 -= (% style="font-size:22px" %)__**Weiteres, funktionsfertiges Beispiel: Rolle „WLAN Profil mit PSK anlegen“**__(%%) =
99 += (% style="font-size:22px" %)__**Funktionsfertiges Beispiel: Rolle „WLAN Profil mit PSK anlegen“**__(%%) =
100 100  
101 101  
102 102  Zum besseren Verständnis wird nachfolgend eine feste Autoconf-Rolle zur Konfiguration eines WLAN-Profils (SSID inkl. PSK) an Clients näher beleuchtet.
... ... @@ -226,8 +226,8 @@
226 226  
227 227  (% style="color:#19177c" %)**Linux Variante (Network Manager)**
228 228  
229 -{{code width="50%" language="text"}}
230 -root@ctrl-g1:~ # cat /usr/lib/ld-autoconf/logodidact/roles/ld_wlan_psk/win/main.ps1
229 +{{code language="text" width="50%"}}
230 +root@ctrl-g1:~ # cat /usr/lib/ld-autoconf/logodidact/roles/ld_wlan_psk/lin/main.ps1
231 231  {{/code}}
232 232  
233 233  {{code language="powershell" width="50%"}}
... ... @@ -289,3 +289,78 @@
289 289   exit 1
290 290  }
291 291  {{/code}}
292 +
293 +----
294 +
295 += (% style="font-size:22px" %)__**Beispiel: eigene AutoConf-Rolle zur "Deaktivierung der Suchhervorhebung in Windows"**__(%%) =
296 +
297 += =
298 +
299 +(((
300 +Im nachfolgenden Beispiel wird eine einfache Rolle zur Deaktivierung der Suchvorhebung in Windows deklariert. 
301 +\\[[image:attach:windowSearchHiglight-PNG.PNG||height="487" width="1051" class="img-thumbnail"]]
302 +
303 +
304 +== (% style="font-size:16px" %)**Aufbau der Logodidact.yml:**(%%) ==
305 +
306 +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
307 +"**{{code language="bash"}}disableSearchHighlight{{/code}}**".
308 +
309 +{{code language="yaml" width="45%"}}
310 +#logodidact.yml
311 +
312 +ld_info:
313 + authors:
314 + - Olav Krapp
315 + - Marcel Petersen
316 + - Kerim Ekin
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:
333 + - CUSTOM #Ausführungszeitpunkt während der/den Phase(n)
334 + systems:
335 + - WINDOWS #Betriebssystem
336 +{{/code}}
337 +
338 +
339 +
340 +(% style="font-size:16px" %)**Aufbau der main.ps1:**(%%)
341 +\\Danach erfolgt die Erstellung des ausführbaren Codes per Powershell. Im ersten Abschnitt Param werden die in der im vorigen Abschnitt definierten Variaben "vars" aus der logodidact.yml aufgeführt und definiert. Bei der Variable "disableSearchHighlight" 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.
342 +\\{{code language="powershell"}}#main.ps1
343 +
344 +Param
345 +(
346 + [parameter(Mandatory=$false)] #Variable zwingend erforderlich?
347 + [bool] #Variablentyp
348 + $disableSearchHighlight #Name der def. Variable aus logodidact.yml
349 +)
350 +
351 +$SystemVersion=[System.Environment]::OSVersion.Version #Hole Windows Systemversion
352 +
353 +if ($SystemVersion.Major -eq 10 -and $SystemVersion.Build -ge 19044) {
354 + $val = [int]!$disableSearchHighlight
355 + Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
356 + [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
357 +} else {
358 + Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
359 +}{{/code}}
360 +
361 +
362 +\\(% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server:**(%%)
363 +\\[[image:image-20230316102252-3.png||height="122" width="1167"]]
364 +\\Ansicht im LD Control Center nach erfolgreichem Import der AutoConf-Rolle:
365 +\\[[image:image-20230316095106-2.png||class="img-thumbnail"]]
366 +)))
image-20230316094933-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,0 +1,1 @@
1 +43.3 KB
Inhalt
image-20230316095106-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,0 +1,1 @@
1 +47.8 KB
Inhalt
image-20230316102252-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,0 +1,1 @@
1 +166.3 KB
Inhalt
image-20230316102302-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,0 +1,1 @@
1 +166.3 KB
Inhalt