> 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/manual/bedienung-der-plattform/hosts/management/plugins/plugin-hinzufugen.md).

# Plugin hinzufügen

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Plugin hinzufügen** in der rechten oberen Ecke der [Plugin-Übersicht](/docs/manual/bedienung-der-plattform/hosts/management/plugins.md#plugins-ubersicht), um ein neues Plugin zu erstellen. Es öffnet sich die Ansicht **Hosts** → **Plugins** → **Hinzufügen**.

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

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Plugin hinzufügen**, nachdem du alle Einstellungen vorgenommen hast, um das neue Plugin zu erstellen.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Zurück**, um zurück zur Listenübersicht zu gelangen.

{% hint style="danger" %}
**Bitte beachte**: Verlässt du diese Ansicht, ohne auf **Plugin hinzufügen** zu klicken, sind alle bisher vorgenommenen Einstellungen unwiederbringlich verloren!
{% endhint %}

***

## Grundeinstellungen

Hier kannst du verschiedene allgemeine Einstellungen vornehmen.

<figure><img src="/files/88PasntLy2kp1iWx4fCf" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="200.0546875">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td>Gib dem Plugin einen aussagekräftigen Namen.</td></tr><tr><td>Beschreibung</td><td><p>Beschreibe das Plugin genauer.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Dieses Feld ist optional.</p></div></td></tr><tr><td>Skriptsprache</td><td><p>Lege die Skriptsprache für das Plugin-Skript fest.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig ausgewählte Skriptsprache ist <strong>Bash (Shell)</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Skriptsprache</strong>, um eine Liste aller verfügbaren Skriptsprachen auszuklappen.<br></p><p>Folgende Skriptsprachen stehen zur Verfügung:</p><ul><li><strong>Bash (Shell)</strong></li><li><strong>Python 3</strong></li><li><strong>PowerShell</strong></li></ul></td></tr><tr><td>Code-Feld</td><td><p>Füge das Skript in das Code-Feld ein.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Der Code des Skripts und die ausgewählte Skriptsprache müssen übereinstimmen.</p></div></td></tr></tbody></table>

***

## Extrahierte Felder

Du kannst aus dem Plugin-Skript optional Felder extrahieren, die als [benutzerdefinierte Metriken](/docs/manual/bedienung-der-plattform/host-detailansichten/monitoring/custom-metriken.md) in der Host-Detailansicht visualisiert werden können.

<div align="left"><figure><img src="/files/riTantO1ZsunZuEcORdx" alt=""><figcaption></figcaption></figure></div>

Vorlagen für die drei zur Verfügung stehenden Skriptsprachen findest du hier:

* [PowerShell](https://github.com/enginsight/powershell-cm-template/blob/master/setup.ps1)
* [Bash](https://github.com/enginsight/bash-cm-template/blob/master/setup.sh)
* [Python](https://github.com/enginsight/python-cm-template/blob/master/setup.py)

Sobald ein Plugin ausgeführt wurde, erscheinen Name und Typ der extrahierten Felder in der jeweiligen [Plugin-Bearbeitungsansicht](/docs/manual/bedienung-der-plattform/hosts/management/plugins.md#plugin-bearbeitungsansicht).

<div align="left"><figure><img src="/files/MTOfqosnf3YW2VBkpSSj" alt=""><figcaption></figcaption></figure></div>

<i class="fa-pen">:pen:</i> Füge optional eine Beschreibung zu jedem extrahierten Feld hinzu und klicke auf **Änderungen speichern**, um die Änderungen zu übernehmen.

***

## Erweiterte Einstellungen

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld **Erweiterte Einstellungen**, um weitere Optionen anzuzeigen.

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

### Geplante Ausführung

Diese Einstellung ermöglicht es, das Plugins regelmäßig in einem benutzerdefinierten zeitlichen Intervall auszuführen.

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben **Geplante Ausführung**, um das Plugin regelmäßig in einem bestimmten zeitlichen Intervall auszuführen. Es öffnet sich die Zeitintervall-Auswahl (siehe unten), mit der du einen benutzerdefinierten Zeitplan für die Ausführung erstellen kannst.

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.9140625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Zeitzone</td><td><p>Lege die Zeitzone fest, die für das gewählte Zeitintervall gelten soll.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Zeitzone</strong>, um eine Liste aller verfügbaren Zeitzonen auszuklappen, und wähle eine Zeitzone aus.</p></td></tr><tr><td>Cron-Ausdruck</td><td>Zeigt das festgelegte Intervall als Cron-Ausdruck an. Der Cron-Ausdruck aktualisiert sich automatisch, sobald du ein Zeitintervall manuell einstellst.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Cron-Ausdruck</strong>, um den <a href="/pages/7fRmJcqCwKxzZ7mEvMo2">Cron-Ausdruck manuell anzupassen</a>.</td></tr><tr><td>Nächste Ausführung (Lokale Zeitzone)</td><td>Zeigt das genaue Datum und die Uhrzeit für die nächste Ausführung in der <em>lokalen Zeitzone deines Browsers</em> an.</td></tr><tr><td>Beschreibung</td><td>Zeigt das festgelegte Intervall für die regelmäßige Ausführung als Beschreibung in Worten an.</td></tr><tr><td>Zeitintervall-Auswahl</td><td>Lege ein benutzerdefiniertes Ausführungsintervall fest.<br><br>Wähle dazu entsprechend die Minuten, Stunden, Tage im Monat, Monate, oder Wochentage aus.</td></tr></tbody></table>

#### Zugeordnete Hosts

Hier kannst du definieren, für welche Hosts oder Gruppen von Hosts die vorgenommenen Einstellungen gelten sollen.

<figure><img src="/files/84OZZ67GYYOtrEa7ikL5" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Hosts</td><td><p>Lege Hosts fest, für die die vorgenommenen Einstellungen gelten sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Hosts</strong>, um eine Liste aller verfügbaren Hosts auszuklappen, und wähle einen oder mehrere Hosts aus. Oder nutze die Freitexteingabe, um Hosts in der Liste schneller zu finden.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem hinzugefügten Host, um ihn aus dem Feld <strong>Hosts</strong> zu entfernen.</p></td></tr><tr><td>Tag-Verknüpfung</td><td><p>Lege fest, wie viele Tags ein zugeordneter Host enthalten muss, damit die Einstellungen für ihn gelten.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig ausgewählte Tag-Verknüpfung ist <strong>Alle Tags sind bei der Referenz vorhanden</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Tag-Verknüpfung</strong>, um eine Liste aller verfügbaren Optionen auszuklappen.<br><br>Folgende Optionen stehen zur Verfügung:</p><ul><li><strong>Alle Tags sind bei der Referenz vorhanden</strong>: Ein zugeordneter Host muss alle angegebenen Tags enthalten, damit die Einstellungen für ihn gelten.</li><li><strong>Mindestens einer der angegebenen Tags ist vorhanden</strong>: Ein zugeordneter Host muss mindestens einen der angegebenen Tags enthalten, damit die Einstellungen für ihn gelten.</li></ul></td></tr><tr><td>Tags</td><td><p>Lege Tags für Gruppen von Hosts fest, für die die vorgenommenen Einstellungen gelten sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Tags</strong>, um eine Liste aller verfügbaren Tags auszuklappen, und wähle einen oder mehrere Tags aus. Oder nutze die Freitexteingabe, um Tags in der Liste schneller zu finden.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem hinzugefügten Tag, um ihn aus dem Feld <strong>Tags</strong> zu entfernen.</p></td></tr></tbody></table>

#### Ausgeschlossene Hosts

Hier kannst du definieren, welche Hosts oder Gruppen von Hosts von den vorgenommenen Einstellung explizit ausgenommen werden sollen.

{% hint style="info" %}
Die Angabe von ausgeschlossenen Hosts ist optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Ausnahmen definieren** neben **Zugeordnete Hosts**, um die Optionen für **Ausgeschlossene Hosts** anzuzeigen.

<div align="left"><figure><img src="/files/Ij7mAIQCONibozppnzEH" alt="" width="563"><figcaption></figcaption></figure></div>

<i class="fa-gear">:gear:</i> Nimm alle Einstellungen wie bei der Angabe eines zugeordneten Hosts vor.

***

### Unprivilegierte Plugin-Ausführung

Diese Einstellung ermöglicht es, Plugins im unprivilegierten Modus, also ohne Administrator-Rechte (Windows) oder Root-Rechte (Linux) auszuführen. Dazu werden entsprechende Accounts mit eingeschränkten Rechten auf dem Host angelegt.

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben **Unprivilegierte Plugin-Ausführung** und bestätige die Meldung, die erscheint, mit **Bestätigen**, um das Plugin mit eingeschränkten Rechten auszuführen,&#x20;

{% hint style="success" icon="lightbulb" %}
Mehr Informationen, wie die Ausführung von Plugins im unprivilegierten Modus funktioniert, findest du in unserer Knowledge Base: [Wie kann ich in Enginsight Plugins im unprivilegierten Modus ausführen?](https://docs.enginsight.com/docs/knowledge-base/plugins/wie-kann-ich-in-enginsight-mehrere-plugins-gleichzeitig-auf-einem-host-ausfuhren)&#x20;
{% endhint %}

***