Skriptaufgaben
Einführung
Tipp:
Skriptbasierte Aufgaben funktionieren auf Maschinenebene. Um Aufgaben auf Benutzersitzungsebene auszuführen, verwenden Sie stattdessen Externe Aufgaben .
Auf dieser Seite können Sie Skriptaufgaben hinzufügen, die Sie an Ihre individuellen Anforderungen an das Umgebungsmanagement anpassen. Sie können diese Aufgaben dann mit Workspace Environment Management (WEM) automatisieren, indem Sie sie im entsprechenden Konfigurationssatz konfigurieren.
Derzeit bieten wir Ihnen die folgende integrierte Skriptaufgabe an, die Sie verwenden können:
Cloud Health Check
Ermöglicht das Ausführen von Prüfungen, die den Zustand von Virtual Delivery Agents (VDAs) messen. Bei VDA-Integritätsprüfungen wird die mögliche Ursache häufiger Probleme bei der VDA-Registrierung und beim Sitzungsstart gesucht. Cloud Health Check wird unter dem lokalen Systemkonto auf dem Agenthost ausgeführt.
Windows-Dienstverwaltung
Die Windows-Dienstverwaltung bietet häufig verwendete Funktionen für den Windows-Dienst, z. B. Starten, Beenden, Neustarten und Konfigurieren eines oder mehrerer Windows-Dienste.
Starten Sie den Windows-Dienst neu
Dieses Skript überprüft den Status eines Windows-Dienstes. Wenn der Dienst derzeit nicht läuft und der Parameter ForceStart angegeben ist, startet das Skript den Dienst. Unabhängig vom aktuellen Status wird der Dienst neu gestartet, wenn er ausgeführt wird und kein erzwungener Start erforderlich ist, um sicherzustellen, dass er mit der neuesten Konfiguration arbeitet, oder um ihn aus einem blockierten Zustand wiederherzustellen.
Parameter
| Name | Typ | Standard | Verpflichtend | Hinweis |
|---|---|---|---|---|
ServiceNames |
Zeichenfolge | BrokerAgent | False | Gibt den Namen der Dienste an, die verwaltet werden sollen. Wenn nicht angegeben, wird standardmäßig auf BrokerAgent gesetzt. Wenn Sie mehr als einen Dienst eingeben müssen, trennen Sie die Dienstnamen durch ein Komma. Alle Leerzeichen würden gekürzt. Zum Beispiel ServiceA, ServiceB. |
ForceStart |
boolean | true | False | Gibt an, ob der Dienst gestartet werden soll, wenn festgestellt wird, dass er nicht läuft. Laufende Dienste sind davon nicht betroffen. Laufende Dienste werden zu Wartungs- oder Wiederherstellungszwecken immer neu gestartet. |
Beenden Sie den Windows-Dienst
Dieses Skript stoppt eine Liste der angegebenen Windows-Dienste. Das Skript überprüft, ob die einzelnen Dienste installiert sind, und versucht, das Stoppen des Dienstes zu erzwingen. Das Skript überprüft dann, ob der Dienst erfolgreich beendet wurde, und meldet den Status.
Parameter
| Name | Typ | Standard | Verpflichtend | Hinweis |
|---|---|---|---|---|
ServiceNames |
Zeichenfolge | BrokerAgent | False | Gibt den Namen der Dienste an, die verwaltet werden sollen. Wenn nicht angegeben, wird standardmäßig auf BrokerAgent gesetzt. Wenn Sie mehr als einen Dienst eingeben müssen, trennen Sie die Dienstnamen durch ein Komma. Alle Leerzeichen würden gekürzt. Zum Beispiel ServiceA, ServiceB. |
Windows-Dienst konfigurieren
Dieses Skript passt die Windows-Dienstkonfigurationen an, einschließlich des Starttyps und der Wiederherstellungsaktionen.
Parameter
| Name | Typ | Standard | Verpflichtend | Hinweis |
|---|---|---|---|---|
ServiceNames |
Zeichenfolge | Null | true | Gibt den Namen der Dienste an, die verwaltet werden sollen. Wenn nicht angegeben, wird standardmäßig auf BrokerAgent gesetzt. Wenn Sie mehr als einen Dienst eingeben müssen, trennen Sie die Dienstnamen durch ein Komma. Alle Leerzeichen würden gekürzt. Zum Beispiel ServiceA, ServiceB. |
StartupType |
Zeichenfolge | Null | False | Legt den Starttyp des Dienstes fest. Gültige Optionen sind Automatisch, Manuell oder Deaktiviert. |
FirstFailureAction |
Zeichenfolge | Null | False | Definiert die Aktion für den ersten Fehler. Zum Beispiel restart/none. |
SecondFailureAction |
Zeichenfolge | Null | False | Definiert die Aktion für den zweiten Ausfall in Folge. |
SubsequentFailureAction |
Zeichenfolge | Null | False | Definiert die Aktion für alle nachfolgenden Fehler nach der Sekunde. |
Serverneustart
Maschine neu starten
Dieses Skript startet den lokalen Computer mit einer optionalen Delay- und Force-Option neu.
Parameter
| Name | Typ | Standard | Verpflichtend | Hinweis |
|---|---|---|---|---|
Force |
boolean | true | False | Falls angegeben, erzwingen Sie einen sofortigen Neustart, wobei alle nicht gespeicherten Daten oder aktiven Benutzersitzungen ignoriert werden. |
Delay |
Ganzzahl | 10 | False | Gibt die Verzögerung in Sekunden an, bevor der Computer neu gestartet wird. Muss zwischen 3 und 30 Sekunden liegen. Der Standardwert ist 10 Sekunden. |
Verwaltung der CDF-Ablaufverfolgung
CDF-Tracing starten
Dieses Skript verwendet entweder eine CTL-Datei oder eine vordefinierte Kategorie von CTL-Dateien als Eingabe, um den CDF-Werkzeugprozess zu starten und mit der Verfolgung der Modelle in CTL-Dateien zu beginnen.
Parameter
| Name | Typ | Standard | Verpflichtend | Hinweis |
|---|---|---|---|---|
traceOutputPath |
Zeichenfolge | C:\ProgramData\Citrix\WEM\CDFLogs |
False | Gibt den Ausgabepfad von CDF-Berichten an. |
category
|
Zeichenfolge
|
10
|
False
|
Gibt die vordefinierten Kategorien an, mit denen der Trace beginnen soll. Unterstützte Werte sind
allalways on tracingdesktop Server os vdadelivery controllerfederated authentication serviceprovisioning serviceuniversal print servercitrix directorcitrix studiosession recording administrationsession recording playercitrix workspace app for windows |
ctlFilePath |
Zeichenfolge | Null | False | Gibt die ctl-Datei an, mit der der Trace beginnen soll. |
CDF-Tracing beenden
Dieses Skript stoppt die Ablaufverfolgung des CDF-Tools.
Bereinigung von CDF-Protokollen
Es ist nützlich, die CDF-Ablaufverfolgungsprotokolle zu bereinigen, um den Speicherverbrauch zu senken. Es sollte eine Funktion zum Entfernen von CDF-Dateien aus dem angegebenen Verzeichnis bereitstellen.
| Name | Typ | Standard | Verpflichtend | Hinweis |
|---|---|---|---|---|
FileAgeDays |
Ganzzahl | 3 | False | Gibt die Altersschwelle in Tagen an. Dateien und Ordner, die älter als dieser Wert sind, werden gelöscht. Der Standardwert ist 3 Tage und dieser Parameter ist optional. Alle Dateien oder Directors werden gelöscht, wenn der FileAgeDays-Zeitraum weniger als 1 Tag beträgt. |
Tipp:
- Sie können zwischen benutzerdefinierten und integrierten Skriptaufgaben unterscheiden: Benutzerdefinierte Aufgaben sind mit dem Label “CUSTOM” gekennzeichnet und integrierte Aufgaben mit dem Label “CITRIX”.
- Integrierte Skriptaufgaben werden immer über den benutzerdefinierten Aufgaben angezeigt. Benutzerdefinierte Skriptaufgaben werden in absteigender Reihenfolge basierend auf dem Zeitpunkt der letzten Änderung sortiert.
Mit dieser Funktion können Sie die Funktionen von WEM für Ihre individuellen Verwaltungsanforderungen erweitern. Mit der integrierten Skriptaufgabe Cloud Health Check können Sie beispielsweise den Zustand der VDAs messen. Die Aufgabe ist skriptbasiert. Sie können Ihre eigene Script-Datei schreiben. Anschließend fügen Sie die Skriptdatei als Skriptaufgabe zu WEM hinzu, damit Sie die Aufgabe mithilfe von WEM automatisieren können.
Jedes Mal, wenn eine Skriptaufgabe ausgeführt wird, wird ein entsprechender Bericht dafür generiert. Der Bericht enthält Informationen über die Ausführung der Aufgabe, die Ergebnisse der Aufgabenausführung und vieles mehr, sodass Sie Aktivitäten im Zusammenhang mit der Aufgabe überprüfen können.
Skriptaufgabe funktionieren auf einer festgelegten Konfigurationsebene. Ein allgemeiner Arbeitsablauf zur Verwendung von Skriptaufgaben lautet wie folgt:
-
Fügen Sie auf der Seite Skriptaufgaben eine Skriptaufgabe hinzu.
-
Navigieren Sie zu dem Konfigurationssatz, für den Sie die Skriptaufgabe aktivieren möchten.
-
Aktivieren Sie auf der Seite Einstellungen für Skriptaufgaben dieses Konfigurationssatzes die Skriptaufgabe. Siehe Einstellungen für Skriptaufgaben.
-
Zeigen Sie optional Berichte zu der Skriptaufgabe an. Es gibt zwei Möglichkeiten, das zu tun:
- Gehen Sie zu Überwachung > Berichte und sehen Sie sich dort Berichte an.
- Gehen Sie zu Skriptaufgaben oder zur Seite Einstellungen für Skriptaufgaben eines Konfigurationssatzes. Suchen Sie die Skriptaufgabe, wählen Sie die Ellipse aus, und wählen Sie dann Berichte anzeigen aus. Sie werden dann zur Seite Überwachung > Berichte weitergeleitet, wobei die entsprechenden Filter automatisch angewendet werden. Sie können dann verwandte Berichte sehen.
Informationen zu Berichten über Skriptaufgaben finden Sie unter Berichte.
Eine Skriptaufgabe hinzufügen
Um eine Skriptaufgabe hinzuzufügen, führen Sie die folgenden Schritte aus:
-
Klicken Sie auf der Seite Skriptaufgabe auf Skriptaufgabe hinzufügen.
-
Konfigurieren Sie im Assistenten zum Hinzufügen von Skriptaufgaben die folgenden Einstellungen und klicken Sie dann auf Speichern.
-
Name der Aufgabe. Geben Sie einen Namen für die Aufgabe an.
-
Tags. Wählen Sie aus vorhandenen Tags oder geben Sie durch Kommas getrennte Tags ein. Ein Tag darf nicht mehr als 20 Zeichen lang sein. Tags sind wie Stichwörter oder Bezeichnungen. Die Verwendung von Tags ermöglicht es Ihnen, Ihre Aufgaben auf neue Weise zu identifizieren. Sie dienen auch als Filter, sodass Sie Ihre Ansicht von Aufgaben in Skriptaufgaben in Abhängigkeit von für Sie wichtigen Kriterien neu anordnen können. Sie können so viele Tags verwenden, wie Sie möchten.
-
Beschreibung. Geben Sie optional zusätzliche Informationen an, die Ihnen helfen, die Aufgabe zu identifizieren.
-
Dateityp. Wählen Sie einen Dateityp für die Aufgabe aus. Zwei Arten von Dateien werden unterstützt:
- PowerShell. Individuelle PowerShell-Skriptdateien.
- ZIP. Mehrere Dateien in einer einzigen ZIP-Datei gebündelt. ZIP-Dateien, die größer als 10 MB sind, werden nicht unterstützt. Geben Sie nach dem Hochladen einer ZIP-Datei einen Einstiegspunkt an, der angibt, welche Datei zu Beginn der Skriptaufgabe ausgeführt werden soll. Beachten Sie, dass die Einstiegspunktdatei nicht mehr als drei Ebenen tief in der Ordnerstruktur enthalten darf.
-
Datei hochladen. Klicken Sie auf Durchsuchen, navigieren Sie zu der Datei, wählen Sie sie aus, und klicken Sie dann auf Öffnen. Sie kehren zum Assistenten zum Hinzufügen von Skriptaufgaben zurück.
-
Berechtigungen erteilen. Geben Sie die Zugriffsebene an, die Sie der skriptbasierten Aufgabe gewähren möchten. Stellen Sie sicher, dass Sie die mit jeder Option verbundenen Berechtigungen verstehen.
- Vollzugriff. Eine Skriptaufgabe mit Vollzugriff hat umfassenden lokalen Zugriff. Wenn diese Option ausgewählt ist, werden der Skriptaufgabe Berechtigungen erteilt, als ob sie unter dem lokalen Systemkonto ausgeführt würde.
- Eingeschränkter Zugriff (mit Netzwerkzugriff). Eine Skriptaufgabe mit eingeschränktem Zugriff (mit Netzwerkzugriff) hat keinen umfangreichen lokalen Zugriff, kann jedoch auf Netzwerkressourcen zugreifen. Wenn diese Option ausgewählt ist, werden der Skriptaufgabe Berechtigungen erteilt, als ob sie unter dem Netzwerkdienstkonto ausgeführt würde.
- Beschränkter Zugriff (ohne Netzwerkzugriff). Eine Skriptaufgabe mit eingeschränktem Zugriff (ohne Netzwerkzugriff) hat keinen umfangreichen lokalen Zugriff und kann nicht auf Netzwerkressourcen zugreifen. Wenn diese Option ausgewählt ist, werden der Skriptaufgabe Berechtigungen erteilt, als ob sie unter dem lokalen Dienstkonto ausgeführt würde.
For more information, see the Microsoft documentation https://docs.microsoft.com/en-us/windows/security/identity-protection/access-control/security-identifiers#well-known-sids.
-
-
Arbeitsordner. Geben Sie optional den absoluten Pfad des lokalen Ordners auf dem Endbenutzerbetriebssystem ein. Der Arbeitsordner ist der aktuelle Ordner für die Datei, wenn sie gestartet wird. Sie können den Pfad mit Umgebungsvariablen erstellen (z. B. %ProgramFiles%). Wenn nicht angegeben, wird
PSScriptRootals Standardarbeitsordner verwendet. Weitere InformationenPSScriptRootzu finden Sie in der Microsoft-Dokumentation https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.1. -
Generiert diese Aufgabe Ausgabedateien. Wählen Sie aus, ob der hinzugefügte Task Ausgabedateien generiert.
-
Ausgabepfad. Geben Sie einen Pfad relativ zu dem Ordner ein, in dem sich die Datei befindet. Der Pfad muss den Dateinamen und die Dateinamenerweiterung enthalten. Beispiel:
output\report.txt.
Bearbeiten einer Skriptaufgabe
Um eine Skriptaufgabe zu bearbeiten, führen Sie die folgenden Schritte aus:
-
Suchen Sie auf der Seite Skriptaufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld, um schnell nach der Aufgabe zu suchen.
-
Klicken Sie auf die Ellipse der Aufgabe und wählen Sie dann Task bearbeiten aus. Der Assistent zum Bearbeiten von Skriptaufgaben wird angezeigt.
-
Konfigurieren Sie auf der Registerkarte Aufgabeninfo die Einstellungen nach Bedarf.
-
Zeigen Sie auf der Registerkarte Script-Inhalt den Script-Inhalt an.
-
Klicken Sie auf Speichern.
Hinweis:
Sie können keine integrierten Skriptaufgaben bearbeiten.
Löschen einer Skriptaufgabe
Um eine Skriptaufgabe zu löschen, führen Sie die folgenden Schritte aus:
-
Suchen Sie auf der Seite Skriptaufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld, um schnell nach der Aufgabe zu suchen.
-
Klicken Sie auf die Ellipse der Aufgabe und wählen Sie dann Aufgabe löschen aus.
Wichtig:
- Sie können keine integrierten Skriptaufgaben löschen.
- Um eine Skriptaufgabe zu löschen, die derzeit für einige Konfigurationssätze aktiviert ist, müssen Sie sie zunächst in diesen Konfigurationssätzen deaktivieren.
Klonen einer Skriptaufgabe
Führen Sie die folgenden Schritte aus, um eine Skriptaufgabe zu klonen:
-
Suchen Sie auf der Seite Skriptaufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld oder die Tags, um die Aufgabe schnell zu finden.
-
Klicken Sie auf die Auslassungspunkte der Aufgabe und wählen Sie dann Aufgabe klonen aus.
Hinweis:
Beim Klonen einer Aufgabe werden Sie aufgefordert, den Namen zu ändern, um doppelte Namen zu vermeiden.
Option „Aufgabeneinstellungen konfigurieren“
Gehen Sie wie folgt vor, um die Aufgabeneinstellung schnell zu erreichen:
-
Suchen Sie auf der Seite Skriptaufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld oder die Tags, um die Aufgabe schnell zu finden.
-
Klicken Sie auf die Ellipse der Aufgabe und wählen Sie dann Aufgabeneinstellungen konfigurierenaus.
-
Wählen Sie im Assistenten zum Auswählen eines Konfigurationssatzes einen Konfigurationssatz aus.
-
Klicken Sie auf Los, um die gefilterte Aufgabe auf der Seite Einstellungen für skriptbasierte Aufgaben aufzurufen, wo nur die gewählte Aufgabe herausgefiltert wird.
Weitere Informationen
Beispiele für die Verwendung von Skriptaufgaben finden Sie unter: