Änderungen von Dokument Eigene Autoconf-Rolle erstellen

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

Von 35.1 nach 34.2 Von 50.3 nach 50.2

Von Version 50.2

bearbeitet von Tom Altenbrunn
am 2023/03/16 16:40

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 35.1

bearbeitet von Tom Altenbrunn
am 2023/03/16 10:44

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Anhänge (0 geändert, 0 hinzugefügt, 2 gelöscht)
- image-20230316110425-1.png
- image-20230316110525-2.png

Details

Seiteneigenschaften

Inhalt

@@ -28,7 +28,7 @@
  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:
--* **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“.
++* **main.ps1** - Skript wird in allen Phasen ausgeführt, die innerhalb der Beschreibungsdatei {{box}}meta/logodidact.yml{{/box}} festgelegt sind
  * (% 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.
  * (% 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.
  * (% 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.
@@ -40,11 +40,6 @@
  (% style="font-size:12px" %)**Hinweis: **Skripte, die durch ihren Dateinamen auf einzelne Phasen eingeschränkt sind ((% style="color:#8e44ad; font-size:12px" %)lila eingefärbt(% style="font-size:12px" %)), dürfen sich inhaltlich zueinander unterscheiden. Dadurch kann eine Autoconf-Rolle sehr flexibel gestaltet werden und in den verschiedenen Phasen des Deployments unterschiedliche Aktionen ausführen.
  )))
--
-- Nachfolgend sind grafisch die diversen Deploy-Phasen dargestellt, welche ein Client während des Imaging-Vorgangs durchläuft. Die Abarbeitung von AutoConf-Rollen beginnen ab der Phase "**Re-Setup**"
--
-- [[image:image-20230316155817-1.png]]
--
  ----
@@ -123,7 +123,7 @@
  (% style="color:#8e44ad" %)  uuid:(%%) 52318636-c4f5-11ea-baf9-0bff00c66ff4
    visible: true
  (% style="color:#19177c" %)  priority:(%%) 0
--  apply_always: false
++  applyAlways: false
  (% style="color:#f1c40f" %)  tags:(%%)
      - CUSTOM
  (% style="color:#e74c3c" %)  vars:(%%)
@@ -162,7 +162,7 @@
  == (% style="font-size:16px" %)**Inhalt des PowerShell-Skripts main.ps1, das die Variablen entgegennimmt**(%%) ==
--Im Unterverzeichnis {{box}} win/ {{/box}} oder {{box}} lin/ {{/box}} der Autoconf-Rolle können sich wie erläutert unterschiedliche PowerShell-Skripte zur Ausführung in den verschiedenen Phasen befinden.
++Im Unterverzeichnis {{box}} win/ {{/box}} oder {{box}} lin/ {{/box}} der Autoconf-Rolle können sich wie erläutert unterschiedliche PowerShell-Skripte zur Ausführung in den verschiedenen Phasen befinden.
  In dieser Rolle liegt konkret das allgemeingültige Skript {{box}}main.ps1{{/box}} vor, welches die Variablen als Parameter ##$ssid## und ##$psk## intern verwendet.
@@ -296,65 +296,65 @@
  ----
++=  =
++= (% style="font-size:22px" %)__**Weiteres Beispiel: eigene AutoConf-Rolle zur "Deaktivierung der Suchhervorhebung in Windows"**__(%%) =
--= (% style="font-size:22px" %)__**Weiteres Beispiel: eigene AutoConf-Rolle zur „Deaktivierung der Suchhervorhebung in Windows“**__(%%) =
--
  Im nachfolgenden Beispiel wird eine einfache Rolle zur Deaktivierung der Suchvorhebung in Windows deklariert.
  \\[[image:image-20230316103442-2.png||height="530" width="1142" class="img-thumbnail"]]
++(((
  ----
--== (% style="font-size:16px" %)**Aufbau der logodidact.yml**(%%) ==
++== (% style="font-size:16px" %)**Aufbau der Logodidact.yml:**(%%) ==
--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
--"**{{code}}disableSearchHighlight{{/code}}**".
++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
++"**{{code language="bash"}}disableSearchHighlight{{/code}}**".
++
--
  {{code language="yaml" width="45%"}}
  #logodidact.yml
  ld_info:
    authors:
--    - Tom Altenbrunn
      - Olav Krapp
      - Marcel Petersen
      - Kerim Ekin
-- company: SBE network solutions GmbH
-- description: |   #Beschreibung
--   Die Suchhervorhebung in der Windows Suchleiste wird deaktiviert
-- display_name: Windows Suchhervorhebung  #Anzeigename im LD Control Center
-- license: SBE
-- uuid: fec4ff30-b2a6-407f-a6b3-0a621cd7eaf7  #einmalige UUID
-- vars:  #Deklaration der Variablen
--   disableSearchHighlight:  #Name der Variable
--     display_name: Suchhervorhebung im Suchfeld deaktivieren #Anzeigename im LD Control Center
--     optional: true  #Auswahl optional
--     type: BOOLEAN  #Variablentyp Boolean = True/False
--     value: false  #Standardwert false
-- visible: true  #Sichtbarkeit der Variable im LD Control Center
-- priority: 0 #Abarbeitungspriorität
-- apply_always: false
-- tags:
++  company: SBE network solutions GmbH
++  description: |   #Beschreibung
++    Die Suchhervorhebung in der Windows Suchleiste wird deaktiviert
++  display_name: Windows Suchhervorhebung  #Anzeigename im LD Control Center
++  license: SBE
++  uuid: fec4ff30-b2a6-407f-a6b3-0a621cd7eaf7  #einmalige UUID
++  vars:  #Deklaration der Variablen
++    disableSearchHighlight:  #Name der Variable
++      display_name: Suchhervorhebung im Suchfeld deaktivieren #Anzeigename im LD Control Center
++      optional: true  #Auswahl optional
++      type: BOOLEAN  #Variablentyp Boolean = True/False
++      value: false  #Standardwert false
++  visible: true  #Sichtbarkeit der Variable im LD Control Center
++  priority: 0 #Abarbeitungspriorität
++  applyAlways: false #Rolle immer ausführen oder einmalig
++  tags:
      - CUSTOM #Ausführungszeitpunkt während der/den Phase(n)
-- systems:
++  systems:
      - WINDOWS  #Betriebssystem
  {{/code}}
++==  ==
++
  ----
--== (% style="font-size:16px" %)**Aufbau der main.ps1**(%%) ==
++== (% style="font-size:16px" %)**Aufbau der main.ps1:**(%%) ==
--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.
++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.
++\\{{code language="powershell"}}#main.ps1
--{{code language="powershell"}}
--#main.ps1
--
  Param
  (
   [parameter(Mandatory=$false)]  #Variable zwingend erforderlich?
-- [bool]  #Variablentyp
-- $disableSearchHighlight  #Name der def. Variable aus logodidact.yml
++  [bool]  #Variablentyp
++  $disableSearchHighlight  #Name der def. Variable aus logodidact.yml
  )
  $SystemVersion=[System.Environment]::OSVersion.Version  #Hole Windows Systemversion
@@ -361,23 +361,23 @@
  #Beginn des eigentlichen Codes
  if ($SystemVersion.Major -eq 10 -and $SystemVersion.Build -ge 19044) {
-- $val = [int]!$disableSearchHighlight
-- Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
-- [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
++  $val = [int]!$disableSearchHighlight
++  Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
++  [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
  } else {
-- Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
--}
--{{/code}}
++  Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
++}{{/code}}
  ----
--== (% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server**(%%) ==
++== (% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server:**(%%) ==
--[[image:image-20230316110425-1.png||height="124" width="1186" class="img-thumbnail"]]
++[[image:image-20230316103224-1.png||height="128" width="1226" class="img-thumbnail"]]
++----
--== (% style="font-size:16px" %)**Ansicht im LD Control Center**(%%) ==
++== (% style="font-size:16px" %)**Ansicht im LD Control Center:**(%%) ==
--[[image:image-20230316110525-2.png||class="img-thumbnail"]]
--
--
++(% class="wikigeneratedid" %)
++ [[image:image-20230316095106-2.png||class="img-thumbnail"]]
++)))

image-20230316110425-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.TomAltenbrunn@sbede

Größe

...	...	@@ -1,1 +1,0 @@
1		-166.3 KB

Inhalt

image-20230316110525-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.TomAltenbrunn@sbede

Größe

...	...	@@ -1,1 +1,0 @@
1		-48.3 KB

Inhalt