> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-per-windows-gruppenrichtlinie-ausrollen.md).

# Wie kann ich den Enginsight Pulsar per Windows-Gruppenrichtlinie ausrollen?

Es ist möglich, den Enginsight Agenten Pulsar auf mehreren Windows-Hosts, die derselben Domain angehören, automatisch per Gruppenrichtlinie auszurollen. 

Dafür benötigst du ein Skript, dass bei jedem Systemstart überprüft, ob ein Pulsar installiert ist. Ist dies nicht der Fall, wird die Installation des Pulsars auf dem betroffenen Host automatisch durchgeführt. Anschließend musst du die entsprechende Windows-Gruppenrichtlinie konfigurieren.

{% hint style="warning" %}
**Bitte beachte**: Du benötigst für Clients und Server jeweils ein eigenes Skript.
{% endhint %}

Nimm dazu folgende Schritte vor:

{% stepper %}
{% step %}

### Pulsar-Installationsskript erhalten

Folge den [Installationsanweisungen zum Pulsar](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/enginsight-komponenten/pulsar) für die automatische Installation auf Windows-Hosts wie im Enginsight Handbuch beschrieben.
{% endstep %}

{% step %}

### Eigenes Skript erstellen

1. Kopiere das Installationsskript aus **Schritt 4 der Pulsar-Installationsanleitung** und füge es an der markierten Stelle in die folgende Vorlage ein: 

<pre><code>If (Get-Service "Enginsight Pulsar" -ErrorAction SilentlyContinue) {
  break
} Else {
<strong>  # Füge unterhalb dieser Zeile den kopierten Installationsbefehl ein.
</strong>
}
</code></pre>

2. Entferne die Zeile `powershell`. Das vollständige Skript (hier mit verschleierten Werten) sollte anschließend wie folgt aussehen:

```
If (Get-Service "Enginsight Pulsar" -ErrorAction SilentlyContinue) {
  break
} Else {
  $dl='https://api.enginsight.com/v1/_/pulsar/latest/ngs-pulsar-amd64-setup.exe'
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  (New-Object System.Net.WebClient).DownloadFile($dl,"$env:TEMP\ngs-pulsar-setup.exe");
  & "$env:TEMP\ngs-pulsar-setup.exe" `
     -acceptEula=true -interactive=false -license server  `
     -accessKeyId ****                `
     -accessKeySecret ****    `
     -api https://****

}
```

3. Speichere das fertige Skript als PowerShell-Skriptdatei mit der Endung `.ps1`.

{% hint style="warning" %}
**Bitte beachte**: Der Speicherort des Skripts muss für alle Hosts, die der Domain angehören, zugänglich sein. Zudem müssen alle Hosts die Berechtigung besitzen, das Skript auszuführen.
{% endhint %}
{% endstep %}

{% step %}

### Windows-Gruppenrichtlinie konfigurieren

1. Öffne den Gruppenrichtlinienverwaltungs-Editor (**gpedit.msc**) als Administrator.
2. Navigiere für die entsprechende Domain zu **Computerkonfiguration** → **Windows-Einstellungen** → **Skripts (Start/Herunterfahren)** → **Starten**.

<figure><img src="/files/PrhCYpPI3b3D5ug2oIZq" alt=""><figcaption></figcaption></figure>

3. Es öffnet sich ein neues Fenster auf dem Tab **Skripts**. Klicke auf **Hinzufügen**.

<div align="left"><figure><img src="/files/mHQJsItq8dx6QIHFAAWc" alt="" width="297"><figcaption></figcaption></figure></div>

4. Es öffnet sich eine weitere Eingabemaske, in der du einen Skriptnamen sowie Skriptparameter eingeben musst.

<div align="left"><figure><img src="/files/UHGmqwpTwAcZldcFUEXZ" alt="" width="280"><figcaption></figcaption></figure></div>

* Gib als **Skriptname** `powershell.exe` ein.
* Nutze für das Feld **Skriptparameter** folgende Vorlage:

```
-ExecutionPolicy Bypass -File "\<NetzwerkSpeicherpfad>\Policies{<GUID>}\Machine\Scripts\Startup\<SkriptName>.ps1"
```

{% hint style="info" %}
Vergiss dabei nicht, die folgenden Parameter in `<>` entsprechend zu ersetzen:

* `<NetzwerkSpeicherpfad>`
* `<GUID>`
* `<SkriptName>`
  {% endhint %}

5. Klicke auf **OK**, um die Einstellungen zu übernehmen.
   {% endstep %}
   {% endstepper %}

***

## Weitere Ressourcen

* [Wie kann ich den Enginsight Pulsar automatisch auf mehreren persistenten Windows-Systemen ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisch-auf-mehreren-persistenten-windows-systemen-ausrollen.md)
* [Wie kann ich den Enginsight Pulsar manuell auf mehreren persistenten Windows-VMs ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-manuell-auf-mehreren-persistenten-windows-vms-ausrollen.md)
* [Wie kann ich den Enginsight Pulsar automatisiert in flüchtigen Windows-VDI-Umgebungen ausrollen?](/docs/knowledge-base/pulsar/wie-kann-ich-den-enginsight-pulsar-automatisiert-in-fluchtigen-windows-vdi-umgebungen-ausrollen.md)

***