# Installation des OpManager-Agenten auf Geräten mithilfe eines Startskripts

Der OpManager-Agent kann mithilfe von Windows-GPOs auf mehreren Geräten installiert werden. Sie können Startskripte verwenden, um die Agenteninstallation beim Systemstart automatisch bereitzustellen und so eine konsistente und problemlose Installation auf allen Zielgeräten sicherzustellen. Diese Methode ist ideal für große Umgebungen, in denen eine zentralisierte, automatisierte Bereitstellung erforderlich ist.

> **Hinweis:** Stellen Sie sicher, dass das Netzwerk domänenbasiert und nicht arbeitsgruppenbasiert eingerichtet ist. Sie können das Skript sogar so zuordnen, dass es die gesamte Domäne umfasst, selbst wenn der OpManager-Agent nur auf wenigen Geräten installiert ist, da der Agent nur auf Geräten installiert wird, auf denen er noch nicht installiert ist.

1. Gehen Sie in der OpManager-Webkonsole zu **Einstellungen → Erkennung → Agent bereitstellen**.
2. Klicken Sie auf die Schaltfläche **„Download“**, um die ZIP-Datei des OpManager-Agenten herunterzuladen. Entpacken Sie die ZIP-Datei und fügen Sie die entpackten Dateien **OpManagerAgent.msi** und **OPMAgentServerInfo.json** in das lokale Verzeichnis ein.

> **Hinweis:** Es ist zwingend erforderlich, eine aktuelle Kopie der Datei OpManagerAgent.zip herunterzuladen und die darin enthaltenen Dateien für den Installationsprozess zu verwenden.

3. Ermitteln Sie den/die übergeordneten Domänenserver für die Client-Computer und kopieren Sie die entpackten Dateien **OpManagerAgent.msi** und **OPMAgentServerInfo.json** auf diesen/diese Domänenserver.
4. Klicken Sie auf dem AD-Server auf **Start → Ausführen**.
5. Geben Sie **gpmc.msc** ein und klicken Sie auf **OK**.
6. Klicken Sie mit der rechten Maustaste auf die Domäne und wählen Sie **Hier ein GPO erstellen und verknüpfen**.

![Installation des OpManager-Agenten auf Geräten mithilfe eines Startskripts: Fenster zum Erstellen und Verknüpfen eines neuen GPO](https://www.manageengine.com/network-monitoring/help/images/agent-create-and-link-gpo.jpg)

7. Geben Sie einen Namen für das GPO an.
8. Wählen Sie das GPO aus.

> **Hinweis:** Diese Schritte müssen befolgt werden, wenn Sie Agenten nur auf einigen ausgewählten Geräten installieren möchten (siehe dieses [Bild](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-select-devices.jpg)). Befolgen Sie diese Schritte nicht, wenn Sie Agenten auf allen Geräten installieren möchten.
>
> - Klicken Sie auf die Registerkarte **Bereich**.
> - Klicken Sie im Abschnitt **Sicherheitsfilterung** auf **Hinzufügen**.
> - Klicken Sie im Dialogfeld **Benutzer, Computer oder Gruppe auswählen** auf **Objekttypen**.
> - Wählen Sie bestimmte Computerobjekttypen aus und klicken Sie auf **OK**.
> - Geben Sie die Computernamen an und klicken Sie auf **OK**.
> - Klicken Sie abschließend auf **Namen überprüfen** und dann erneut auf **OK**.

9. Klicken Sie mit der rechten Maustaste auf das GPO und anschließend auf **„Bearbeiten“**.

10. Gehen Sie zum Ausführen von **VBScript** wie folgt vor (siehe dieses [Bild](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-vbscript.jpg)):

    - Erweitern Sie **Computerkonfiguration → Richtlinien → Windows-Einstellungen → Skripts**.
    - Klicken Sie mit der rechten Maustaste auf **Start**, und klicken Sie auf **Eigenschaften**.
    - Klicken Sie auf **Dateien anzeigen**.
    - Ziehen Sie die Datei [InstallOPMAgent.vbs](https://www.manageengine.com/network-monitoring/help/files/InstallOPMAgent.txt) (laden Sie die `.txt`-Datei herunter und benennen Sie sie in `.vbs` um) sowie die entpackten Dateien **OpManagerAgent.msi** und **OPMServerInfo.json** per Drag-and-drop an diesen Speicherort. Kopieren Sie den Pfad dieses Speicherorts `(\\Domänenname\SysVol\Domänenname\Policies\{ID}\Machine\Scripts\Startup)` und schließen Sie das Fenster.
    - Klicken Sie im Dialogfeld **Starteigenschaften** auf **Hinzufügen**.
    - Durchsuchen Sie den Speicherort, navigieren Sie dorthin und kopieren Sie den angezeigten Pfad `(\\Domänenname\SysVol\Domänenname\Policies\{ID}\Machine\Scripts\Startup)`.
    - Wählen Sie das Skript **InstallOPMAgent.vbs** aus. Geben Sie dann den Pfad (kopierter Speicherort) und das Skript wie unten angegeben an:

```
(\\Domänenname\SysVol\Domänenname\Policies\{ID}\Machine\Scripts\Startup)\InstallOPMAgent.vbs
```

   - Geben Sie den Skriptparameter wie unten angegeben an:  
     **OpManagerAgent.msi**

11. Alternativ zu VBScript können Sie für die Agenteninstallation per GPO auch ein **PowerShell-Skript** ausführen. Gehen Sie zum Ausführen von PowerShell-Skripten wie folgt vor (siehe dieses [Bild](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-powershell-script.jpg)):

    - Stellen Sie vor der Ausführung dieses Skripts sicher, dass PowerShell auf allen Client-Computern aktiviert ist.
    - Erweitern Sie **Computerkonfiguration → Richtlinien → Windows-Einstellungen → PowerShell-Skripts**.
    - Klicken Sie mit der rechten Maustaste auf **Start**, und klicken Sie auf **Eigenschaften**.
    - Klicken Sie auf **Dateien anzeigen**.
    - Ziehen Sie die Datei [psinstallopmagent.ps1](https://www.manageengine.com/network-monitoring/help/files/psinstallopmagent.txt) (laden Sie die `.txt`-Datei herunter und benennen Sie sie in `.ps1` um) sowie die entpackten Dateien **OpManagerAgent.msi** und **OPMAgentServerInfo.json** per Drag-and-drop an diesen Speicherort. Kopieren Sie den Pfad dieses Speicherorts `(\\Domänenname\SysVol\Domänenname\Policies\{ID}\Machine\Scripts\Startup)` und schließen Sie das Fenster.
    - Klicken Sie im Dialogfeld **Starteigenschaften** auf **Hinzufügen**.
    - Durchsuchen Sie den Speicherort, navigieren Sie dorthin und kopieren Sie den angezeigten Pfad `(\\Domänenname\SysVol\Domänenname\Policies\{ID}\Machine\Scripts\Startup)`.
    - Wählen Sie das Skript **psinstallopmagent.ps1** aus. Geben Sie dann den Pfad (kopierter Speicherort) und das Skript wie unten angegeben an:

```
(\\Domänenname\SysVol\Domänenname\Policies\{ID}\Machine\Scripts\Startup)\psinstallopmagent.ps1
```

   - Geben Sie die Skriptparameter wie unten angegeben an:  
     **OpManagerAgent.msi**

12. Klicken Sie auf **OK**, um das Dialogfeld **Skript hinzufügen** und das Dialogfeld **Starteigenschaften** zu schließen, und schließen Sie anschließend auch die Dialogfelder **Gruppenrichtlinienobjekt-Editor** und **Gruppenrichtlinienverwaltung**.

> **Hinweis:** Dieses Skript kann verwendet werden, um den Agenten auf allen Computern in der Domäne bereitzustellen. Beachten Sie, dass das Ziel keine Benutzergruppe sein darf.

Dieses Skript wird nach der Bereitstellung beim nächsten Neustart der Client-Computer ausgeführt. Sobald dieses Skript erfolgreich ausgeführt wurde, wird der OpManager-Agent auf allen Client-Computern installiert. Sie können diese neu hinzugefügten Geräte auf der Inventarseite in OpManager überprüfen.

> **Hinweis:**
>
> - Die Dateizuordnungseigenschaften von `.vbs`-Dateien müssen auf allen Client-Computern auf **„Microsoft Windows (r) basierter Skripthost“** gesetzt sein, damit das Skript ordnungsgemäß ausgeführt wird. Wenn die Dateizuordnungseigenschaften so geändert wurden, dass die Skriptdatei mit einem Texteditor geöffnet wird, schlägt die Ausführung fehl.
> - Das OpManager-GPO-Objekt kann unverändert bestehen bleiben, um den Agenten künftig automatisch auf neuen Client-Computern zu installieren.
> - Sie müssen sich keine Sorgen machen, dass der Agent erneut installiert wird, da das Skript so geschrieben wurde, dass eine unnötige Neuinstallation des Agenten verhindert wird.
> - Sie müssen sich auch keine Sorgen über die regelmäßige Aktualisierung des Agenten machen. Updates für den OpManager-Agenten werden zusammen mit den OpManager-Installationsdateien veröffentlicht, und OpManager überträgt das Agentenupdate automatisch an die Client-Computer, sobald es verfügbar ist.

Die Installation des OpManager-Agenten auf mehreren Geräten mithilfe von Windows-GPO kann hilfreich sein, insbesondere wenn andere Installationsmethoden fehlschlagen. Nachfolgend finden Sie einige häufige Gründe für Fehler bei der Agenteninstallation, damit Sie das Problem identifizieren und beheben können.

- [Zugriff verweigert](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#access_denied)
- [Netzwerkpfad nicht gefunden](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#network_path_not_found)
- [Unbekannter Benutzername oder unbekanntes Passwort](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#login_failure)
- [Kein Netzwerkanbieter hat den angegebenen Netzwerkpfad akzeptiert](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#network_path_not_accepted)
- [Nicht genügend Speicherplatz verfügbar, um den Agenten zu installieren](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#not_enough_server_storage)

Wenn bei der Agenteninstallation andere Probleme aufgetreten sind, [kontaktieren Sie bitte unser Support-Team](mailto:opmanager-support@manageengine.com), damit diese behoben werden können.