So konfigurieren Sie Benachrichtigungsskripte:
Klicken Sie auf der Registerkarte Benachrichtigungen auf Aufgaben > Neu im Bereich Benachrichtigungen (oder klicken Sie auf das Pluszeichen-Symbol).
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.
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):
Benachrichtigungsarten
Die folgende Tabelle listet die unterstützten Benachrichtigungsarten auf (die Spalte ID repräsentiert Werte, die an die Befehlszeilenvariable ($NOTIFICATION-TYPE) übergeben werden):
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)
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:
https://docs.microsoft.com/de-de/dotnet/standard/base-types/standard-date-and-time-format-strings
Hinweis: 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.
($NOTIFICATION-TYPE)
Ein numerischer Wert, der jeder Benachrichtigungsart zugeordnet ist. Die Werte der Benachrichtigungsarten sind in der unten stehenden Tabelle Benachrichtigungsarten aufgeführt.
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.
Um Benachrichtigungs-Handler zu konfigurieren:
Navigieren Sie in der RAS-Konsole zu Serverfarm > Site > Einstellungen.
Wählen Sie die Registerkarte Benachrichtigungen.
Klicken Sie auf Aufgaben > Neu (oder klicken Sie auf das Plus-Symbol), um ein Ereignis zu wählen, für das ein Handler erstellt werden soll. Informationen über die Liste der Ereignisse und deren Beschreibung finden Sie unter Systemereignisse.
Ein Dialogfeld wird geöffnet, in dem Sie die Ereignis-Handler-Einstellungen festsetzen können.
Geben Sie auf der Registerkarte Allgemein die folgenden Optionen an:
Den Grenzwert (Zahl oder Prozentsatz). Für einige Ereignisse nicht verfügbar (wie z. B. Lizenzierung, Agent).
Die Richtung (ob das Ereignis ausgelöst werden soll, wenn der Wert den angegebenen Wert über- oder unterschreitet). Für einige Ereignisse nicht verfügbar (wie oben).
Ob der Administrator per E-Mail verständigt werden soll.
Zusätzliche E-Mail-Adressen (können durch Komma oder Semikolon getrennt werden), an die Ereignisbenachrichtigungen gesendet werden sollen.
Ob ein Skript ausgeführt werden soll, wenn das Ereignis ausgelöst wird. Hier müssen Sie die Option Benachrichtigungsskript ausführen auswählen und dann ein Skript aus der Dropdownliste auswählen. Bevor Sie diese Option verwenden können, müssen Sie ein oder mehrere Skripte erstellen, wie unter Benachrichtigungsskripte konfigurieren beschrieben.
Geben Sie auf der Registerkarte Kriterien Folgendes an:
Typ: Wählen Sie die Art von Objekten aus, die Meldungen auslösen.
Alle Server der Site: Wählen Sie diese Option, aus, um alle verfügbaren Server miteinzubeziehen.
Verfügbar: Wählen Sie die Objekte aus, die Meldungen auslösen.
Geben Sie auf der Registerkarte Einstellungen Folgendes an:
Standardeinstellungen verwenden: Wählen Sie diese Option, um die Standardeinstellungen zu verwenden. Um die Standardwerte zu bearbeiten, klicken Sie auf den Link Standardwerte bearbeiten. Um benutzerdefinierte Einstellungen zu verwenden, deaktivieren Sie diese Option und setzen Sie die Optionen fest, wie nachstehend beschrieben.
Toleranzfrist für den Benachrichtigungs-Handler: Geben Sie den Zeitraum (in Minuten) ein, die ab dem Auftreten des Ereignisses bis zum Auslösen der Benachrichtigung vergehen sollen. Einige Ereignisse können ausgelöst werden, aber nur für einen sehr kurzen Zeitraum andauern. Eine CPU-Auslastung kann zum Beispiel plötzlich stark über den angegebenen Grenzwert ansteigen, dann aber schnell wieder zum Normalwert zurückkehren. Für solche Ereignisse kann es sinnvoll sein, dass nicht sofort eine Benachrichtigung ausgelöst wird. Mit dieser Option können Sie die Verzögerung angeben.
Benachrichtigungsintervall: Geben Sie die Mindestzeitspanne (in Minuten) zwischen der letzten und der nächsten Benachrichtigung an. Damit kann verhindert werden, dass mehrere Benachrichtigungen schnell hintereinander an Administratoren geschickt werden (d. h. Spamming wird verhindert).
Eine Benachrichtigung senden und weitere Benachrichtigungen bis zur Wiederherstellung aussetzen: Wenn diese Einstellung aktiviert ist, wird nur einmal eine Benachrichtigung verschickt und danach wird sie ausgesetzt, bis die von der Benachrichtigung überwachten Werte wieder im vorgegebenen Bereich liegen. Wenn z. B. die CPU-Auslastung über dem Grenzwert für den ganzen Tag liegt, dann führt RAS den Benachrichtigungs-Handler nicht mehrmals aus, sondern nur einmal.
Wenn Sie fertig sind, klicken Sie auf OK, um den Benachrichtigungs-Handler zu speichern.
Beachten Sie, dass das Postfach in der RAS-Konsole für die abgehenden E-Mails konfiguriert werden muss. Dieses Postfach wird normalerweise eingerichtet, wenn Sie die RAS-Konsole zum ersten Mal ausführen und dann mit der Kategorie Starten Ihre RAS-Umgebung einrichten. Sie können auch eine Mailbox einrichten, wie unter SMTP-Server-Verbindung für Ereignisbenachrichtigungen konfigurieren beschrieben.
Um einen Ereignis-Handler zu aktivieren oder zu deaktivieren, kreuzen Sie das Kontrollkästchen in der ersten Spalte an oder leeren Sie es, oder klicken Sie mit der rechten Maustaste auf ein Ereignis und wählen Sie Aktivieren oder Deaktivieren. Um einen Handler zu ändern, klicken Sie mit der rechten Maustaste darauf und wählen Sie Eigenschaften. Um einen Handler zu löschen, klicken Sie mit der rechten Maustaste darauf und wählen Sie Löschen.
Systemereignisse
Sie können Benachrichtungs-Handler für die folgenden Systemereignisse erstellen:
CPU-Auslastung. Wird ausgelöst, wenn die CPU-Auslastung einen bestimmten Wert über- oder unterschreitet.
Speicherauslastung. Wird ausgelöst, wenn die Speicherauslastung einen bestimmten Wert über- oder unterschreitet.
Anzahl der RDSH-Sitzungen. Wird ausgelöst, wenn die Anzahl der aktiven Sitzungen einen bestimmten Wert über- oder unterschreitet.
Anzahl der unterbrochenen RDSH-Sitzungen. Wird ausgelöst, wenn die Anzahl der unterbrochenen Sitzungen einen bestimmten Wert über- oder unterschreitet.
Nutzung von RDSH-Sitzungen. Wird ausgelöst, wenn die Anzahl der RDSH-Sitzungen einen bestimmten Prozentsatz der maximalen Anzahl der Sitzungen über- oder unterschreitet.
Nutzung von unterbrochenen RDSH-Sitzungen. Wird ausgelöst, wenn die Anzahl der nicht verbundenen RDSH-Sitzungen einen bestimmten Prozentsatz der maximalen Anzahl von Sitzungen über- oder unterschreitet.
Nutzung von AVD-Sitzungen. Wird ausgelöst, wenn die Anzahl der AVD-Sitzungen einen bestimmten Prozentsatz der maximalen Anzahl der Sitzungen über- oder unterschreitet.
Nutzung von getrennten AVD-Sitzungen. Wird ausgelöst, wenn die Anzahl der getrennten AVD-Sitzungen einen bestimmten Prozentsatz der maximalen Anzahl der Sitzungen über- oder unterschreitet.
Anzahl der getunnelten Gateway-Sitzungen. Wird ausgelöst, wenn die Anzahl der getunnelten Gatewaysitzungen einen bestimmten Wert über- oder unterschreitet.
Fehlgeschlagene getunnelte Gateway-Sitzungen. Wird ausgelöst, wenn zwischen einem Gateway und einem Ressourcenobjekt keine Verbindung hergestellt werden kann.
RAS Agents-Ereignisse. Löst aus, wenn ein Agent-Ereignis eintritt (z. B. Agents trennen oder wieder verbinden).
Lizenzierungsereignisse. Wird ausgelöst, wenn ein Lizenzierungsereignis eintritt. Zu den erwähnenswerten Ereignissen gehört das Erreichen eines vorab definierten Limits für die Lizenznutzung. Insbesondere, wenn die Lizenznutzung 90 % aller verfügbaren Lizenzen erreicht, erhalten Sie eine E-Mail, sodass Sie Zeit haben zu entscheiden, ob Sie genügend Lizenzen besitzen oder weitere hinzufügen müssen. Andere Ereignisse sind beispielsweise die Aktivierung/Deaktivierung von Lizenzen, Ablauf von Lizenzen, Beginn/ Ende des Kulanzzeitraums, Änderungen der Lizenzinformationen, Kommunikationsprobleme mit dem Lizenzserver.
Authentifizierungsserverereignisse. Wird ausgelöst, wenn ein Verbindungsproblem mit einem Authentifizierungsserver auftritt.
Veröffentlichte Elementereignisse. Wird ausgelöst, wenn ein publiziertes Item-Ereignis eintritt (z. B. das Concurrent Instance Limit für eine Anwendung erreicht ist).
Vorlagenereignisse. Wird ausgelöst, wenn ein VDI-Ereignis eintritt (z. B. Vorlage wurde nicht gefunden).
Mandantenereignisse. Wird ausgelöst, wenn ein Mandantenereignis eintritt. Weitere Informationen finden Sie unter Mandantenfähige RAS-Architektur> Konfigurieren von Benachrichtigungen.
Weitere Hinweise dazu finden Sie auch in der Tabelle Benachrichtigungsarten im Abschnitt Konfigurieren von Benachrichtigungsskripten.
Auf der Registerkarte Postfach können Sie in der Kategorie Verwaltung einen SMTP-Server für ausgehende E-Mails konfigurieren. Der SMTP-Server wird vom Administrator benötigt, um Benachrichtigungen über Systemereignisse (wie in den vorhergehenden Abschnitten beschrieben) zu erhalten und Einladungs-E-Mails an die Benutzer zu senden.
So konfigurieren Sie einen SMTP-Server:
Wählen Sie in der RAS-Konsole die Kategorie Verwaltung und klicken Sie auf die Registerkarte Postfach.
Geben Sie im Feld Mailserver Ihre Mailserver FDQN oder IP-Adresse ein.
In der Dropdownliste TLS/SSL wählen Sie, ob Sie das Protokoll verwenden.
Wählen Sie SMTP-Server erfordert Authentifizierung, wenn erforderlich, und geben Sie den Benutzernamen und das Passwort für den SMTP-Server in die entsprechenden Felder ein).
Im Abschnitt Absender-Informationen geben Sie die E-Mail-Adresse des Absenders ein (beispielsweise Ihre E-Mail-Adresse).
Im Abschnitt Mailbox-Einstellungen testen können Sie Ihre SMTP-Server-Konfiguration testen. Geben Sie eine oder mehrere E-Mail-Adressen ein, die Sie durch Semikola trennen. Klicken Sie auf Test-E-Mail senden, um die Einstellungen zu testen.
Sie können Systemereignis-Benachrichtigungen auf der Registerkarte Serverfarm > Site > Einstellungen > Benachrichtigungen konfigurieren. Mit Benachrichtigungen wird der Administrator über Systemereignisse per E-Mail informiert. Wenn Sie Benachrichtigungen konfigurieren, gelten diese Einstellungen für alle Server in der Farm.
Um Benachrichtigungen zu konfigurieren, müssen Sie zunächst Benachrichtigungs-Handler konfigurieren, in denen Sie Schwellenwerte angeben können (sofern verfügbar) und ob ein Administrator per E-Mail benachrichtigt werden soll. Sie können auch Benachrichtigungsskripte konfigurieren, die automatisch ausgeführt werden, wenn ein Ereignis eintritt.