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
- Windows Server 2019 oder neuer
- Windows-Geräte, die bereits mit der Domäne verbunden sind
1. Anmeldeinformationen für GPO generieren
-
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.)
-
Navigieren Sie zu
Devicesund klicken Sie oben rechts auf die SchaltflächeImport via GPO.

- Klicken Sie oben rechts auf die Schaltfläche
Create new secret.

- Konfigurieren Sie die folgenden beiden wichtigen Werte:
Expiration date: Legen Sie das Ablaufdatum für den Anmeldetoken fest. Nach diesem Datum wird der Token ungültig.Associated user: Legen Sie den Benutzer fest, unter dem die Geräte in der Redamp.io-Plattform angezeigt werden.
Klicken Sie anschließend auf die Schaltfläche Create, um das Geheimnis zu generieren.

- Laden Sie das Skript
RedampDistribution.ps1herunter, indem Sie auf die SchaltflächeDownload scriptklicken, und kopieren Sie den generierten Token.

- 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:
Domain Computers: alle Computer, die mit Ihrer Domäne verbunden sind. Das Skript läuft auf jedem Gerät unter dem Konto des Computers selbst, nicht unter dem angemeldeten Benutzer. Deshalb müssen die Geräte die Token-Datei lesen können. Sie erhalten nur Lesezugriff.Domain Admins: Ihre Domänenadministratoren. Sie erhalten Vollzugriff, damit sie den Ordner verwalten und den Token beim Erneuern ersetzen können.
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
-
Öffnen Sie auf einem Dateiserver den
File Explorerund wechseln Sie zu dem Laufwerk, auf dem der Ordner liegen soll, zum BeispielC:\. -
Aktivieren Sie die Dateierweiterungen unter
View->Show->File name extensions, damit die Datei nicht alstoken.txt.txtgespeichert wird. -
Klicken Sie mit der rechten Maustaste auf eine freie Stelle, wählen Sie
New->Folderund nennen Sie den OrdnerRedampToken. -
Öffnen Sie den Ordner, klicken Sie mit der rechten Maustaste und wählen Sie
New->Text Document. Nennen Sie die Dateitoken.txt. -
Ö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.

Ordnerberechtigungen festlegen
-
Klicken Sie mit der rechten Maustaste auf den Ordner
RedampTokenund wählen SieProperties->Security->Advanced. -
Klicken Sie auf
Disable inheritanceund wählen SieConvert inherited permissions into explicit permissions on this object.

-
Markieren Sie alle Einträge in der Liste
Permission entriesund klicken Sie aufRemove, sodass die Liste leer ist. -
Klicken Sie auf
Add->Select a principal, geben SieDomain Computersein und klicken Sie aufCheck NamesundOK. Behalten Sie die StandardberechtigungenRead & execute,List folder contentsundRead, setzen SieApplies toaufThis folder, subfolders and filesund klicken Sie aufOK.

-
Klicken Sie erneut auf
Addund fügen SieDomain Adminsauf die gleiche Weise hinzu, diesmal mitFull control. -
Prüfen Sie, dass die Liste nur
Domain Computers(Read & execute) undDomain Admins(Full control) enthält, und klicken Sie dann aufApplyundOK.

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
-
Klicken Sie mit der rechten Maustaste auf den Ordner
RedampTokenund wählen SieProperties->Sharing->Advanced Sharing.... -
Wählen Sie
Share this folderund geben Sie alsShare nameden WertRedampToken$ein. Das$am Ende verbirgt die Freigabe beim Durchsuchen des Netzwerks.

-
Klicken Sie auf
Permissions, wählen SieEveryoneund klicken Sie aufRemove. -
Klicken Sie auf
Add..., fügen SieDomain Computershinzu und erlauben Sie nurRead.

- Klicken Sie erneut auf
Add..., fügen SieDomain Adminshinzu und erlauben SieFull Control. Wenn SieDomain Controllerszu den Ordnerberechtigungen hinzugefügt haben, fügen Sie die Gruppe auch hier mitReadhinzu.

- Klicken Sie zweimal auf
OK. Notieren Sie sich auf der RegisterkarteSharingdenNetwork 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.

- 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.
- Oeffnen Sie
Active Directory Users and Computers, klicken Sie aufViewund aktivieren SieAdvanced Features.

-
Oeffnen Sie die Eigenschaften des Ziel-Geraetekontos und wechseln Sie zur Registerkarte
Attribute Editor. -
Suchen Sie das Attribut
commentund 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.

- Pruefen Sie, ob alle erforderlichen Geraete Teil der ausgewaehlten AD-Gruppe sind.

- Fahren Sie mit dem naechsten Schritt fort und konfigurieren Sie die GPO-Bereitstellung.
4. Installation von Redamp.io über GPO
- Öffnen Sie das Fenster
Group Policy Managementüber das Suchfeld oder überServer Manager->Tools->Group Policy Management.

- Erstellen Sie ein neues GPO, indem Sie mit der rechten Maustaste auf den Ordner
Group Policy Objectsunter Ihrer Domäne klicken und die OptionNewwählen.

- Geben Sie den GPO-Namen ein (z. B.
Redamp Distribution Script) und klicken Sie auf die SchaltflächeOK.

- Klicken Sie mit der rechten Maustaste auf das erstellte GPO und wählen Sie
Edit....

- Navigieren Sie zu
Computer Configuration->Policies->Windows Settings->Scripts.

-
Klicken Sie dann mit der rechten Maustaste auf
Startup->Properties. -
Wechseln Sie zur Registerkarte
PowerShell Scriptsund klicken Sie auf die SchaltflächeShow Files....

- Es öffnet sich ein freigegebenes Verzeichnis; legen Sie dort das Skript RedampDistribution.ps1 ab, das Sie von der Website heruntergeladen haben.


- Sie können nun das freigegebene Verzeichnis schließen. Klicken Sie auf die Schaltfläche
Add..., dann aufBrowse...und wählen Sie das Skript RedampDistribution.ps1, das Sie im vorherigen Schritt abgelegt haben.
- Fügen Sie einen der folgenden Parameter hinzu:
| Parameter | Beschreibung | Erforderlich | Beispiel |
|---|---|---|---|
| -SecretFile | Pfad zur Token-Datei auf der geschützten Freigabe aus Schritt 2 (empfohlen) | Ja, oder -Secret verwenden | \\DC01\RedampToken$\token.txt |
| -Secret | Der in Schritt 1 generierte Token, direkt eingegeben | Ja, oder -SecretFile verwenden | Random string |

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.
-
Klicken Sie auf die Schaltfläche
OK, um die Änderungen zu speichern. -
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....

- Wählen Sie das GPO aus, das Sie in den vorherigen Schritten erstellt haben, und klicken Sie auf die Schaltfläche
OK.

- Um die Richtlinie zu erzwingen, ändern Sie die Spalte
EnforcedaufYes.

- Das PowerShell-Skript installiert die Anwendung Redamp.io, nachdem das Windows-Gerät neu gestartet wurde. Wenn der Windows-Schnellstart aktiviert ist, startet
Shut downdas Gerät nicht vollständig neu. Verwenden Sie daherRestart. 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:
-
Laden Sie in Redamp.io das aktuelle
RedampDistribution.ps1herunter (Devices->Import via GPO->Download script) und ersetzen Sie das Skript in Ihrem GPO. -
Erstellen Sie die geschützte Freigabe aus Schritt 2.
-
Ersetzen Sie in den Skriptparametern des GPO
-Secret <token>durch-SecretFile \\DC01\RedampToken$\token.txtund verwenden Sie dabei den Pfad Ihrer Freigabe.