> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-admin-guide/v21-de-de/allgemeine-managementaufgaben/ereignisbenachrichtigungen-des-systems/konfigurieren-von-benachrichtigungsskripten.md).

# Konfigurieren von Benachrichtigungsskripten

So konfigurieren Sie Benachrichtigungsskripte:

1. Klicken Sie auf der Registerkarte **Benachrichtigungen** auf **Aufgaben** > **Neu** im Bereich **Benachrichtigungen** (oder klicken Sie auf das Pluszeichen-Symbol).
2. Geben Sie in dem sich öffnenden Dialogfeld die folgenden Optionen an:
   * **Skriptname:** Geben Sie einen aussagekräftigen Namen für die Verbindung an.
   * **Befehl:** Der auszuführende Befehl.
   * **Argumente:** Befehlszeilenargumente, die an den Befehl übergeben werden. Ein Argument kann eine der vordefinierten Variablen sein, die Parallels RAS automatisch durch einen tatsächlichen Wert ersetzt. Siehe untenstehende Tabelle der **Befehlszeilenvariablen** (die Spalte ID enthält die Werte, die hier verwendet werden können).
   * **Anfangsverzeichnis:** Der vollständige Pfad zum aktuellen Verzeichnis des Prozesses. Die Zeichenfolge kann auch einen UNC-Pfad angeben.
   * **Benutzername, Passwort:** Dies sind optionale Felder, die Sie angeben können, wenn Sie den Befehl unter einem bestimmten Benutzerkonto ausführen möchten.
3. Klicken Sie anschließend auf **OK**, um das Benachrichtigungsskript zu speichern.

Um ein Benachrichtigungsskript zu ändern, klicken Sie mit der rechten Maustaste darauf und wählen Sie **Eigenschaften**.

Um ein Skript zu löschen, klicken Sie mit der rechten Maustaste und wählen Sie **Löschen**. Wenn ein Benachrichtigungs-Handler ein Skript verwendet, wird eine Warnmeldung angezeigt. Wenn Sie es trotzdem löschen, wird die Skript-Zuordnung aus allen Benachrichtigungs-Handlern entfernt, in denen es verwendet wird, und alle betroffenen Handler werden automatisch so konfiguriert, dass sie eine E-Mail-Benachrichtigung senden.

**Variablen der Befehlszeile**

Die folgende Tabelle listet Befehlszeilenvariable auf, die Sie bei der Ausführung eines Skripts als Argumente verwenden können (siehe Beschreibung der Option **Argumente** oben):

| **Variable**         | **Beschreibung**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ($FARM-NAME)         | Name der RAS-Farm, die die Benachrichtigung ausgelöst hat.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ($SITE-NAME)         | Name der RAS-Site, die die Benachrichtigung ausgelöst hat.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ($SERVER-ADDRESS)    | IP-Adresse oder FQDN des Servers, der die Benachrichtigung ausgelöst hat. Es kann ein RDSH-Server, der Server mit einem RAS Connection Broker, RAS Secure Gateway usw. sein.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ($TRIGGER-ADDRESS)   | IP-Adresse oder FQDN des Connection Brokers, der die Benachrichtigung ausgelöst hat.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ($THRESHOLD-VALUE)   | Der Schwellenwert, der dem Meldungsbearbeiter zugeordnet ist. Wenn eine Benachrichtigungsart keine Schwellenwerte unterstützt, sollte das Argument durch eine leere Zeichenfolge ersetzt werden.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ($NOTIFICATION-TIME) | <p>GMT-Uhrzeit und Datum des Eintretens des Ereignisses. Das Zeichenfolgenformat muss die Formatangabe R“ oder r“ verwenden. Bitte lesen Sie den folgenden Artikel von Microsoft für Details:</p><p><a href="https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings"><https://docs.microsoft.com/de-de/dotnet/standard/base-types/standard-date-and-time-format-strings></a></p><p><strong>Hinweis:</strong> Die Uhrzeit sollte den Zeitpunkt des Auftretens der Meldung darstellen und nicht den Zeitpunkt, zu dem der Benachrichtungs-Handler ausgeführt wurde. Der Benachrichtungs-Handler kann verzögert ausgeführt werden, wenn eine Nachfrist aktiviert ist.</p> |
| ($NOTIFICATION-TYPE) | Ein numerischer Wert, der jeder Benachrichtigungsart zugeordnet ist. Die Werte der Benachrichtigungsarten sind in der unten stehenden Tabelle **Benachrichtigungsarten** aufgeführt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

**Benachrichtigungsarten**

Die folgende Tabelle listet die unterstützten Benachrichtigungsarten auf (die Spalte ID repräsentiert Werte, die an die Befehlszeilenvariable ($NOTIFICATION-TYPE) übergeben werden):

| **Benachrichtigungsart**                                               | **ID** | **Beschreibung**                                                                                                                                                                                                        |
| ---------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CPU-Nutzung                                                            | 1      | Diese Benachrichtigung wird ausgelöst, wenn die CPU-Auslastung einen bestimmten Wert über- oder unterschreitet.                                                                                                         |
| Speicherauslastung                                                     | 2      | Diese Benachrichtigung wird ausgelöst, wenn die Speicherauslastung einen bestimmten Wert über- oder unterschreitet.                                                                                                     |
| Anzahl der aktiven Sitzungen                                           | 3      | Diese Benachrichtigung wird ausgelöst, wenn die Anzahl der aktiven Sitzungen einen bestimmten Wert über- oder unterschreitet.                                                                                           |
| Anzahl der unterbrochenen Sitzungen                                    | 4      | Diese Benachrichtigung wird ausgelöst, wenn die Anzahl der unterbrochenen Sitzungen einen bestimmten Wert über- oder unterschreitet.                                                                                    |
| RAS-Agent erneut verbinden                                             | 5      | Agent wieder verbunden.                                                                                                                                                                                                 |
| RAS Agent trennen                                                      | 6      | Verbindung zum Agent getrennt.                                                                                                                                                                                          |
| VDI-Vorlage fehlt                                                      | 7      | Diese Benachrichtigung wird ausgelöst, wenn ein VDI-Ereignis eintritt (z. B. Template wurde nicht gefunden)                                                                                                             |
| Limit der veröffentlichten Anwendungen überschritten                   | 8      | Diese Benachrichtigung wird ausgelöst, wenn ein Ereignis mit einem veröffentlichten Element eintritt (z. B. das Instanzlimit einer veröffentlichten Anwendung wurde überschritten).                                     |
| Multi-CB-Kommunikationsfehler                                          | 9      | Kommunikationsfehler bei Multi-CB.                                                                                                                                                                                      |
| Authentifizierungsanbieter nicht erreichbar                            | 10     | Diese Benachrichtigung wird ausgelöst, wenn ein Verbindungsproblem mit dem Authentifizierungsserver auftritt.                                                                                                           |
| % der RDSH-Sitzung außerhalb des maximal angegebenen Wertes            | 11     | Diese Benachrichtigung wird ausgelöst, wenn die Anzahl der RDSH-Sitzungen den angegebenen Prozentsatz der maximalen Anzahl der Sitzungen über- oder unterschreitet.                                                     |
| Gateway ist Tunneling mal Anzahl der Sitzungen                         | 12     | Diese Benachrichtigung wird ausgelöst, wenn die Anzahl der getunnelten Gateway-Sitzungen einen bestimmten Wert über- oder unterschreitet.                                                                               |
| % der getrennten RDSH-Sitzung außerhalb des maximal angegebenen Wertes | 13     | Diese Benachrichtigung wird ausgelöst, wenn die Anzahl der unterbrochenen RDSH-Sitzungen den angegebenen Prozentsatz der maximalen Anzahl der Sitzungen über- oder unterschreitet.                                      |
| Auto Promotion von Connection Broker                                   | 20     | Auto Promotion von Connection Broker                                                                                                                                                                                    |
| Auto Promotion von Connection Broker fehlgeschlagen                    | 21     | Auto Promotion von Connection Broker fehlgeschlagen                                                                                                                                                                     |
| Failback bei Auto Promotion von Connection Broker                      | 22     | Failback bei Auto Promotion von Connection Broker                                                                                                                                                                       |
| CA nicht verfügbar                                                     | 30     | Diese Benachrichtigung wird ausgelöst, wenn ein Verbindungsproblem mit dem Authentifizierungszertifikat auftritt.                                                                                                       |
| Lizenzsite in den Failover-Modus geschaltet                            | 50     | Failover-Modus Connection Brokers.                                                                                                                                                                                      |
| Lizenzierungssite ist offline                                          | 51     | Lizenzierungssite ist offline.                                                                                                                                                                                          |
| Lizenzsite wieder verbunden                                            | 52     | Lizenzierungssite ist wieder online.                                                                                                                                                                                    |
| IP des Lizenzierungs-CB geändert                                       | 53     | Die IP-Adresse des lizenzierenden Connection Brokers wurde geändert.                                                                                                                                                    |
| Hostname des lizenzierenden Connection Brokers geändert                | 54     | Der Hostname des lizenzierenden Connection Brokers wurde geändert.                                                                                                                                                      |
| IP des sekundären Connection Brokers geändert                          | 55     | Die IP-Adresse des nicht lizenzierenden Connection Brokers wurde geändert.                                                                                                                                              |
| Hostname des sekundären Connection Brokers wurde geändert              | 56     | Der Hostname des nicht lizenzierenden Connection Brokers wurde geändert.                                                                                                                                                |
| Vorlagen max Anzahl der Gäste erreicht                                 | 60     | Vorlage max. Anzahl der Gäste wurde erreicht.                                                                                                                                                                           |
| Vorlagen max Anzahl der Server erreicht                                | 61     | Vorlage max Serverlimit erreicht                                                                                                                                                                                        |
| Vorlagen Klonen fehlgeschlagen                                         | 62     | Vorlage Klonen fehlgeschlagen.                                                                                                                                                                                          |
| Lizenz aktiviert                                                       | 100    | Diese Benachrichtigung wird ausgelöst, wenn ein Lizenzierungsereignis eintritt (z. B. eine Farm wurde erfolgreich aktiviert).                                                                                           |
| Lizenz deaktiviert                                                     | 101    | Lizenz wurde deaktiviert.                                                                                                                                                                                               |
| Max. Lizenznutzung                                                     | 102    | Die maximale Lizenznutzung hat x % erreicht.                                                                                                                                                                            |
| Lizenz läuft aus                                                       | 103    | Wenn die Lizenz demnächst abläuft, benachrichtigen Sie jeden Tag über die Anzahl der verbleibenden Tage.                                                                                                                |
| Lizenz abgelaufen                                                      | 104    | Lizenz abgelaufen.                                                                                                                                                                                                      |
| Lizenz-Testversion abgelaufen                                          | 105    | Testphase abgelaufen                                                                                                                                                                                                    |
| Beginn der Lizenz-Nachfrist                                            | 106    | Nachfrist gestartet.                                                                                                                                                                                                    |
| Ende der Lizenz-Nachfrist                                              | 107    | Nachfrist abgelaufen.                                                                                                                                                                                                   |
| Lizenz deaktiviert                                                     | 108    | Lizenz wurde deaktiviert.                                                                                                                                                                                               |
| Lizenzinformationen geändert                                           | 109    | Lizenzinformationen geändert                                                                                                                                                                                            |
| Kommunikation der Lizenz mit Chipkarte fehlgeschlagen                  | 110    | Kommunikation mit Lizenzierungsserver fehlgeschlagen                                                                                                                                                                    |
| Keine Lizenzdatei                                                      | 111    | Lizenzdatei konnte nicht geladen werden.                                                                                                                                                                                |
| Ungültige Lizenzversion                                                | 112    | Ungültige Lizenzdateiversion.                                                                                                                                                                                           |
| Ungültige Lizenzsignatur                                               | 113    | Ungültig Lizenzdateisignatur.                                                                                                                                                                                           |
| Ungültige Lizenz                                                       | 114    | Systemfehler.                                                                                                                                                                                                           |
| Ungültige MAC-Adresse der Lizenz                                       | 115    | Ungültige MAC-Adresse (Änderung an der Hardware).                                                                                                                                                                       |
| Nachfrist bei Lizenzen ohne Signatur                                   | 116    | Nachfrist für Migration gestartet.                                                                                                                                                                                      |
| Mandant registriert                                                    | 200    | Diese Benachrichtigung wird ausgelöst, wenn ein Ereignis in Bezug auf einen registrierten Mandanten eintritt (z. B. ein neuer Mandant wurde dem Mandantenmakler hinzugefügt oder ein Mandant ist nicht mehr verfügbar). |
| Mandantenstatus geändert                                               | 201    | Mandantenstatus geändert                                                                                                                                                                                                |
| Maklerstatus geändert                                                  | 202    | Mandantenmakler-Status geändert                                                                                                                                                                                         |
| Registrierung des Mandant aufgehoben                                   | 203    | Mandant hat die Verbindung zum Makler getrennt                                                                                                                                                                          |
| Getunnelte Standard-Serverfarm-Sitzung fehlgeschlagen                  | 220    | Getunnelte Standard-Sitzung fehlgeschlagen.                                                                                                                                                                             |
| Getunnelte Maklerfarm-Sitzung fehlgeschlagen                           | 221    | Getunnelte Mandantenmakler-Sitzung fehlgeschlagen.                                                                                                                                                                      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.parallels.com/landing/ras-admin-guide/v21-de-de/allgemeine-managementaufgaben/ereignisbenachrichtigungen-des-systems/konfigurieren-von-benachrichtigungsskripten.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
