Installation von Redamp.io über GPO

Erfahren Sie, wie Sie Redamp.io mit GPO (Group Policy Object) auf all Ihren Windows-Geräten installieren.

Voraussetzungen

1. Anmeldeinformationen für GPO generieren

  1. Melden Sie sich als Administrator bei Redamp.io an. (Wenn Sie Partner sind, klicken Sie auf einen bestimmten Kunden, um dessen Dashboard zu öffnen und fahren Sie mit dem nächsten Schritt fort.)

  2. Navigieren Sie zu Devices und klicken Sie oben rechts auf die Schaltfläche Import via GPO.

Redamp.io | Über GPO importieren
  1. Klicken Sie oben rechts auf die Schaltfläche Create new secret.
Redamp.io | Anmeldeinformationen generieren
  1. Konfigurieren Sie die folgenden beiden wichtigen Werte:

Klicken Sie anschließend auf die Schaltfläche Create, um das Geheimnis zu generieren.

Redamp.io | Neues Geheimnis erstellen
  1. Laden Sie das Skript RedampDistribution.ps1 herunter, indem Sie auf die Schaltfläche Download script klicken, und kopieren Sie den generierten Token.
Redamp.io | Anweisungen befolgen
  1. Fahren Sie mit dem nächsten Schritt fort.

2. Token auf einer geschützten Freigabe speichern (empfohlen)

Wir empfehlen, den Token in einer Datei auf einer Freigabe abzulegen, die nur Domänencomputer lesen können. Der Token steht dann nicht in der Gruppenrichtlinien-Konfiguration, und wenn Sie den Token erneuern, ersetzen Sie nur die Datei. Das GPO bleibt unverändert.

Wer Zugriff bekommt und warum

Sie geben genau zwei Gruppen Zugriff:

Niemand sonst erhält Zugriff. Normale Benutzer melden sich mit ihren eigenen Benutzerkonten an, die nicht Mitglied von Domain Computers sind. Sie können die Datei daher nicht öffnen, auch nicht auf denselben Computern.

Dieser Schritt ist optional. Wenn Sie eine schnellere Einrichtung bevorzugen, überspringen Sie ihn und geben Sie den Token in Schritt 4 direkt mit dem Parameter -Secret ein.

Ordner und Token-Datei erstellen

  1. Öffnen Sie auf einem Dateiserver den File Explorer und wechseln Sie zu dem Laufwerk, auf dem der Ordner liegen soll, zum Beispiel C:\.

  2. Aktivieren Sie die Dateierweiterungen unter View -> Show -> File name extensions, damit die Datei nicht als token.txt.txt gespeichert wird.

  3. Klicken Sie mit der rechten Maustaste auf eine freie Stelle, wählen Sie New -> Folder und nennen Sie den Ordner RedampToken.

  4. Öffnen Sie den Ordner, klicken Sie mit der rechten Maustaste und wählen Sie New -> Text Document. Nennen Sie die Datei token.txt.

  5. Öffnen Sie token.txt, fügen Sie den Token aus Schritt 1 ein und speichern Sie die Datei. Die Datei darf nur den Token enthalten.

File Explorer | Ordner mit der Token-Datei

Ordnerberechtigungen festlegen

  1. Klicken Sie mit der rechten Maustaste auf den Ordner RedampToken und wählen Sie Properties -> Security -> Advanced.

  2. Klicken Sie auf Disable inheritance und wählen Sie Convert inherited permissions into explicit permissions on this object.

Windows | Vererbung deaktivieren
  1. Markieren Sie alle Einträge in der Liste Permission entries und klicken Sie auf Remove, sodass die Liste leer ist.

  2. Klicken Sie auf Add -> Select a principal, geben Sie Domain Computers ein und klicken Sie auf Check Names und OK. Behalten Sie die Standardberechtigungen Read & execute, List folder contents und Read, setzen Sie Applies to auf This folder, subfolders and files und klicken Sie auf OK.

Windows | Leseberechtigung für Domain Computers
  1. Klicken Sie erneut auf Add und fügen Sie Domain Admins auf die gleiche Weise hinzu, diesmal mit Full control.

  2. Prüfen Sie, dass die Liste nur Domain Computers (Read & execute) und Domain Admins (Full control) enthält, und klicken Sie dann auf Apply und OK.

Windows | Ordnerberechtigungen

Wenn das GPO auch für Domänencontroller gilt, fügen Sie zusätzlich Domain Controllers mit Read & execute hinzu. Domänencontroller sind nicht Mitglied von Domain Computers.

Ordner freigeben

  1. Klicken Sie mit der rechten Maustaste auf den Ordner RedampToken und wählen Sie Properties -> Sharing -> Advanced Sharing....

  2. Wählen Sie Share this folder und geben Sie als Share name den Wert RedampToken$ ein. Das $ am Ende verbirgt die Freigabe beim Durchsuchen des Netzwerks.

Windows | Freigabename
  1. Klicken Sie auf Permissions, wählen Sie Everyone und klicken Sie auf Remove.

  2. Klicken Sie auf Add..., fügen Sie Domain Computers hinzu und erlauben Sie nur Read.

Windows | Freigabeberechtigung für Domain Computers
  1. Klicken Sie erneut auf Add..., fügen Sie Domain Admins hinzu und erlauben Sie Full Control. Wenn Sie Domain Controllers zu den Ordnerberechtigungen hinzugefügt haben, fügen Sie die Gruppe auch hier mit Read hinzu.
Windows | Freigabeberechtigung für Domain Admins
  1. Klicken Sie zweimal auf OK. Notieren Sie sich auf der Registerkarte Sharing den Network Path, zum Beispiel \\DC01\RedampToken$. Der vollständige Pfad zur Token-Datei lautet dann \\DC01\RedampToken$\token.txt. Sie benötigen ihn in Schritt 4.
Windows | Netzwerkpfad der Freigabe
  1. Klicken Sie auf Close.

Optional: Einrichtung überprüfen

Wenn Sie sicherstellen möchten, dass der Token geschützt ist, melden Sie sich an einem Domänengerät als normaler Benutzer an und geben Sie den vollständigen Pfad zur Token-Datei im File Explorer ein. Windows sollte den Zugriff verweigern. Das ist so gewollt: Die Geräte selbst können die Datei weiterhin lesen, weil sie das Computerkonto verwenden.

Fahren Sie mit dem nächsten Schritt fort.

3. Zuordnung von Geraeten zu E-Mail ueber das comment-Attribut

Damit sich die Redamp.io-Anwendung nach der Installation auf jedem Geraet mit dem gewuenschten Konto anmeldet, muessen Sie im Attribut comment eine gueltige E-Mail-Adresse aus Ihrer AD-Domaene hinterlegen. Wenn in diesem Attribut keine E-Mail-Adresse gesetzt ist, meldet sich die Anwendung mit dem zuerst angemeldeten Benutzer aus der AD-Domaene an. Falls dieser Prozess fehlschlaegt, wird ein Standardkonto zugewiesen.

  1. Oeffnen Sie Active Directory Users and Computers, klicken Sie auf View und aktivieren Sie Advanced Features.
Active Directory | Advanced Features aktivieren
  1. Oeffnen Sie die Eigenschaften des Ziel-Geraetekontos und wechseln Sie zur Registerkarte Attribute Editor.

  2. Suchen Sie das Attribut comment und setzen Sie die Ziel-E-Mail-Adresse (z. B. test.email@my_domain.com). Sie koennen jede E-Mail-Adresse aus Ihrer AD-Domaene verwenden, unter der die Geraete angemeldet werden sollen.

Active Directory | Comment-Attribut mit E-Mail
  1. Pruefen Sie, ob alle erforderlichen Geraete Teil der ausgewaehlten AD-Gruppe sind.
Active Directory | Geraetegruppe
  1. Fahren Sie mit dem naechsten Schritt fort und konfigurieren Sie die GPO-Bereitstellung.

4. Installation von Redamp.io über GPO

  1. Öffnen Sie das Fenster Group Policy Management über das Suchfeld oder über Server Manager -> Tools -> Group Policy Management.
Redamp.io | Server-Manager
  1. Erstellen Sie ein neues GPO, indem Sie mit der rechten Maustaste auf den Ordner Group Policy Objects unter Ihrer Domäne klicken und die Option New wählen.
Redamp.io | Neues GPO erstellen
  1. Geben Sie den GPO-Namen ein (z. B. Redamp Distribution Script) und klicken Sie auf die Schaltfläche OK.
Redamp.io | GPO-Name
  1. Klicken Sie mit der rechten Maustaste auf das erstellte GPO und wählen Sie Edit....
Redamp.io | GPO bearbeiten
  1. Navigieren Sie zu Computer Configuration -> Policies -> Windows Settings -> Scripts.
Redamp.io | Speicherort der Skripte
  1. Klicken Sie dann mit der rechten Maustaste auf Startup -> Properties.

  2. Wechseln Sie zur Registerkarte PowerShell Scripts und klicken Sie auf die Schaltfläche Show Files....

Redamp.io | PowerShell-Skript hinzufügen
  1. Es öffnet sich ein freigegebenes Verzeichnis; legen Sie dort das Skript RedampDistribution.ps1 ab, das Sie von der Website heruntergeladen haben.
Redamp.io | Freigegebenes Verzeichnis durchsuchen
Redamp.io | Freigegebenes Verzeichnis mit Skript
  1. Sie können nun das freigegebene Verzeichnis schließen. Klicken Sie auf die Schaltfläche Add..., dann auf Browse... und wählen Sie das Skript RedampDistribution.ps1, das Sie im vorherigen Schritt abgelegt haben.
ParameterBeschreibungErforderlichBeispiel
-SecretFilePfad zur Token-Datei auf der geschützten Freigabe aus Schritt 2 (empfohlen)Ja, oder -Secret verwenden\\DC01\RedampToken$\token.txt
-SecretDer in Schritt 1 generierte Token, direkt eingegebenJa, oder -SecretFile verwendenRandom string
Redamp.io | Skriptparameter hinzufügen

Beide Varianten installieren Redamp.io und melden es auf die gleiche Weise an. Wenn sich die Geräte mit -SecretFile nicht anmelden, zum Beispiel weil der Dateiserver beim Start der Geräte nicht erreichbar ist, ersetzen Sie den Parameter durch -Secret und den Token.

  1. Klicken Sie auf die Schaltfläche OK, um die Änderungen zu speichern.

  2. Klicken Sie mit der rechten Maustaste auf die Organisationseinheit, in der Sie Redamp.io verteilen möchten, und wählen Sie Link an existing GPO....

Redamp.io | Organisationseinheit auswählen
  1. Wählen Sie das GPO aus, das Sie in den vorherigen Schritten erstellt haben, und klicken Sie auf die Schaltfläche OK.
Redamp.io | GPO auswählen
  1. Um die Richtlinie zu erzwingen, ändern Sie die Spalte Enforced auf Yes.
Redamp.io | Richtlinie erzwingen
  1. Das PowerShell-Skript installiert die Anwendung Redamp.io, nachdem das Windows-Gerät neu gestartet wurde. Wenn der Windows-Schnellstart aktiviert ist, startet Shut down das Gerät nicht vollständig neu. Verwenden Sie daher Restart. Auf Geräten, auf denen Redamp.io bereits installiert ist, tut das Skript nichts, und die Anwendung hält sich selbst aktuell.

Bestehende Bereitstellung auf die geschützte Freigabe umstellen

-Secret funktioniert weiterhin, eine Änderung ist also nicht nötig. So wechseln Sie zur empfohlenen Einrichtung:

  1. Laden Sie in Redamp.io das aktuelle RedampDistribution.ps1 herunter (Devices -> Import via GPO -> Download script) und ersetzen Sie das Skript in Ihrem GPO.

  2. Erstellen Sie die geschützte Freigabe aus Schritt 2.

  3. Ersetzen Sie in den Skriptparametern des GPO -Secret <token> durch -SecretFile \\DC01\RedampToken$\token.txt und verwenden Sie dabei den Pfad Ihrer Freigabe.