Skriptaufgaben
Einführung
Tipp
Skriptgesteuerte Aufgaben funktionieren auf Computerebene. Um Aufgaben auf Benutzersitzungsebene auszuführen, verwenden Sie Externe Aufgaben stattdessen.
Auf dieser Seite können Sie skriptgesteuerte Aufgaben hinzufügen, die Sie an Ihre individuellen Anforderungen an die Umgebungsverwaltung anpassen. Sie können diese Aufgaben dann mit Workspace Environment Management (WEM) automatisieren, indem Sie sie im entsprechenden Konfigurationssatz konfigurieren.
Derzeit stellen wir die folgende integrierte skriptgesteuerte Aufgabe zur Verfügung, die Sie verwenden können:
- Cloud-Gesundheitsprüfung
- Verwaltung von Windows-Diensten
- Server Reoobt
- Verwaltung der CDF-Rückverfolgung
Cloud-Gesundheitsprüfung
Ermöglicht das Ausführen von Überprüfungen, mit denen die Integrität von Virtual Delivery Agents (VDAs) gemessen wird. VDA-Zustandsprüfungen ermitteln mögliche Ursachen für häufige Probleme bei der VDA-Registrierung und beim Starten von Sitzungen. Die Cloud-Integritätsprüfung wird unter dem lokalen Systemkonto auf dem Agent-Host ausgeführt.
Verwaltung von Windows-Diensten
Die Windows-Dienstverwaltung bietet häufig verwendete Funktionen für Windows-Dienste, wie z. B. Starten, Stoppen, Neustarten, 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 ausgeführt wird und die ForceStart angegeben ist, startet das Skript den Dienst. Unabhängig vom aktuellen Zustand wird der Dienst, wenn er ausgeführt wird und kein erzwungener Start erforderlich ist, neu gestartet, um sicherzustellen, dass er mit der neuesten Konfiguration ausgeführt wird, oder um einen angehaltenen Zustand wiederherzustellen.
Parameter
| Name | Art | Vorgabe | obligatorisch | Hinweis: |
|---|---|---|---|---|
ServiceNames |
string | Makleragent | FALSCH | Gibt den Namen der zu verwaltenden Dienste an. Wenn nicht angegeben, wird standardmäßig Makleragent. Wenn Sie mehr als einen Dienst eingeben müssen, trennen Sie die Dienstnamen durch ein Komma. Alle Leerzeichen würden gekürzt. Beispiel: ServiceA, ServiceB. |
ForceStart |
boolean | STIMMT | FALSCH | Gibt an, ob der Dienst gestartet werden soll, wenn festgestellt wird, dass er nicht ausgeführt wird. Laufende Dienste sind davon nicht betroffen. Laufende Dienste werden zu Wartungs- oder Wiederherstellungszwecken immer neu gestartet. |
Windows-Dienst stoppen
Dieses Skript stoppt eine Liste der angegebenen Windows-Dienste. Das Skript überprüft, ob jeder Dienst installiert ist, und versucht, das Beenden des Dienstes zu erzwingen. Das Skript überprüft dann, ob der Dienst erfolgreich beendet wurde, und meldet den Status.
Parameter
| Name | Art | Vorgabe | obligatorisch | Hinweis: |
|---|---|---|---|---|
ServiceNames |
string | Makleragent | FALSCH | Gibt den Namen der zu verwaltenden Dienste an. Wenn nicht angegeben, wird standardmäßig Makleragent. Wenn Sie mehr als einen Dienst eingeben müssen, trennen Sie die Dienstnamen durch ein Komma. Alle Leerzeichen würden gekürzt. Beispiel: ServiceA, ServiceB. |
Konfigurieren des Windows-Dienstes
Dieses Skript passt Windows-Dienstkonfigurationen an, einschließlich des Starttyps und der Wiederherstellungsaktionen.
Parameter
| Name | Art | Vorgabe | obligatorisch | Hinweis: |
|---|---|---|---|---|
ServiceNames |
string | null | STIMMT | Gibt den Namen der zu verwaltenden Dienste an. Wenn nicht angegeben, wird standardmäßig Makleragent. Wenn Sie mehr als einen Dienst eingeben müssen, trennen Sie die Dienstnamen durch ein Komma. Alle Leerzeichen würden gekürzt. Beispiel: ServiceA, SerivceB. |
StartupType |
string | null | FALSCH | Legt den Starttyp des Diensts fest. Gültige Optionen sind “Automatisch”, “Manuell” oder “Deaktiviert”. |
FirstFailureAction |
string | null | FALSCH | Definiert die Aktion für den ersten Fehler. Beispiel: restart/none. |
SecondFailureAction |
string | null | FALSCH | Definiert die Aktion für den zweiten aufeinanderfolgenden Fehler. |
SubsequentFailureAction |
string | null | FALSCH | Definiert die Aktion für alle nachfolgenden Fehler nach dem zweiten Fehler. |
Neustart des Servers
Maschine neu starten
Dieses Skript startet den lokalen Computer mit einer optionalen Option delay and force neu.
Parameter
| Name | Art | Vorgabe | obligatorisch | Hinweis: |
|---|---|---|---|---|
Force |
boolean | STIMMT | FALSCH | Falls angegeben, erzwingen Sie einen sofortigen Neustart, wobei nicht gespeicherte Daten oder aktive Benutzersitzungen ignoriert werden. |
Delay |
Ganzzahl | 10 | FALSCH | 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-Rückverfolgung
Starten der CDF-Ablaufverfolgung
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 | Art | Vorgabe | obligatorisch | Hinweis: |
|---|---|---|---|---|
traceOutputPath |
string | C:\ProgramData\Citrix\WEM\CDFLogs |
FALSCH | Gibt den Ausgabepfad von CDF-Berichten an. |
category
|
string
|
10
|
FALSCH
|
Gibt die vordefinierten Kategorien an, mit denen die Ablaufverfolgung gestartet werden soll. Unterstützte Werte sind
alleImmer auf der RückverfolgungDesktop Server Betriebssystem vdaSteuerung der AuslageDienst für die VerbundauthentifizierungProvisioning-ServiceUniverseller DruckserverCitrix-DirektorCitrix StudioVerwaltung der SitzungsaufzeichnungPlayer für die Aufzeichnung von SitzungenCitrix Workspace-App für Windows |
ctlFilePath |
string | null | FALSCH | Gibt die CTL Datei, mit der die Ablaufverfolgung gestartet werden soll. |
CDF-Ablaufverfolgung stoppen
Dieses Skript stoppt die Ablaufverfolgung des CDF-Werkzeugs.
Bereinigung von CDF-Protokollen
Es ist sinnvoll, die CDF-Ablaufverfolgungsprotokolle zu bereinigen, um Speicherplatz zu sparen. Es sollte eine Funktion zum Entfernen von CDF-Dateien im angegebenen Verzeichnis bereitstellen.
| Name | Art | Vorgabe | obligatorisch | Hinweis: |
|---|---|---|---|---|
FileAgeDays |
Ganzzahl | 3 | FALSCH | Gibt den Altersschwellenwert 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 die Schaltfläche DateiAlterTage weniger als 1 Tag beträgt. |
Tipp
- Sie können zwischen benutzerdefinierten und integrierten Skriptaufgaben unterscheiden: Benutzerdefinierte Aufgaben sind mit dem Label “CUSTOM” gekennzeichnet, integrierte mit dem Label “CITRIX”.
- Integrierte skriptgesteuerte Aufgaben werden immer über benutzerdefinierten Aufgaben angezeigt. Benutzerdefinierte skriptgesteuerte Aufgaben 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 skriptgesteuerten Aufgabe Cloud Health Check können Sie z. B. die Integrität der VDAs messen. Die Aufgabe ist skriptbasiert. Sie können eine eigene Skriptdatei schreiben. Anschließend fügen Sie die Skriptdatei als Skriptaufgabe zu WEM hinzu, damit Sie die Aufgabe mit WEM automatisieren können.
Jedes Mal, wenn eine skriptgesteuerte Aufgabe ausgeführt wird, wird ein entsprechender Bericht für sie generiert. Der Bericht enthält Informationen darüber, wann die Aufgabe ausgeführt wird, die Ergebnisse der Aufgabenausführung und vieles mehr, sodass Sie Aktivitäten im Zusammenhang mit der Aufgabe überwachen können.
Skriptbasierte Aufgaben arbeiten auf Konfigurationssatzebene. Ein allgemeiner Workflow für die Verwendung von Skriptaufgaben sieht wie folgt aus:
-
Am Skriptbasierte Aufgaben eine skriptgesteuerte Aufgabe hinzu.
-
Navigieren Sie zu dem Konfigurationssatz, für den Sie die skriptgesteuerte Aufgabe aktivieren möchten.
-
Am Einstellungen für skriptgesteuerte Aufgaben Seite dieses Konfigurationssatzes, aktivieren Sie die skriptgesteuerte Aufgabe. Siehe Einstellungen für skriptgesteuerte Aufgaben.
-
Optional können Sie Berichte anzeigen, die sich auf die skriptgesteuerte Aufgabe beziehen. Es gibt zwei Möglichkeiten, dies zu tun:
- Gehe zu Überwachung > Berichte und sehen Sie sich dort Berichte an.
- Gehe zu Skriptbasierte Aufgaben oder die Einstellungen für skriptgesteuerte Aufgaben Seite eines Konfigurationssatzes. Suchen Sie die skriptgesteuerte Aufgabe, wählen Sie die Auslassungspunkte aus, und wählen Sie dann Anzeigen von Berichten. Sie werden dann zum Überwachung > Berichte Seite, wobei die entsprechenden Filter automatisch angewendet werden. Sie können dann zugehörige Berichte anzeigen.
Weitere Hinweise zu skriptgesteuerten Aufgabenberichten finden Sie unter Berichte.
Eine Skriptaufgabe hinzufügen
Um eine skriptgesteuerte Aufgabe hinzuzufügen, führen Sie die folgenden Schritte aus:
-
Am Skriptgesteuerte Aufgabe Seite, klicken Sie auf Hinzufügen einer skriptgesteuerten Aufgabe.
-
Im Hinzufügen einer skriptgesteuerten Aufgabe Assistenten, konfigurieren Sie die folgenden Einstellungen und klicken Sie dann auf Retten.
-
Name der Aufgabe. Geben Sie einen Namen für die Aufgabe an.
-
Tags. Wählen Sie aus vorhandenen Tags aus oder geben Sie Tags durch Kommas getrennt ein. Ein Tag darf nicht länger als 20 Zeichen sein. Tags sind wie Schlüsselwörter oder Labels. Die Verwendung von Tags ermöglicht es Ihnen, Ihre Aufgaben auf neue Weise zu identifizieren. Außerdem fungieren sie als Filter, mit denen Sie Ihre Ansicht der Aufgaben in Skriptaufgaben je nach Kriterien, die für Sie wichtig sind, 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 bei der Identifizierung der Aufgabe helfen.
-
Dateityp. Wählen Sie einen Dateityp für die Aufgabe aus. Es werden zwei Arten von Dateien unterstützt:
- PowerShell. Einzelne PowerShell-Skriptdateien.
- SCHWIRREN. 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 am Anfang der skriptgesteuerten Aufgabe ausgeführt werden soll. Beachten Sie, dass sich die Einstiegspunktdatei nicht mehr als drei Ebenen tief in der Ordnerstruktur befinden darf.
-
Datei hochladen. Klicken Blättern, navigieren Sie zu der Datei, wählen Sie sie aus, und klicken Sie dann auf Offen. Sie kehren zum Hinzufügen einer skriptgesteuerten Aufgabe Zauberer.
-
Berechtigungen erteilen. Geben Sie die Zugriffsebene an, die Sie der skriptgesteuerten Aufgabe gewähren möchten. Stellen Sie sicher, dass Sie die Berechtigungen verstehen, die den einzelnen Optionen zugeordnet sind.
- Voller Zugriff. Eine skriptgesteuerte Aufgabe, der Vollzugriff zugewiesen ist, verfügt über umfangreichen lokalen Zugriff. Wenn diese Option ausgewählt ist, werden der skriptgesteuerten Aufgabe Berechtigungen erteilt, als ob sie unter dem lokalen Systemkonto ausgeführt wird.
- Eingeschränkter Zugriff (mit Netzwerkzugang). Ein skriptgesteuerter Task, dem eingeschränkter Zugriff (mit Netzwerkzugriff) zugewiesen ist, verfügt nicht über umfassenden lokalen Zugriff, kann aber auf Netzwerkressourcen zugreifen. Wenn diese Option ausgewählt ist, werden der skriptgesteuerten Aufgabe Berechtigungen erteilt, als ob sie unter dem Netzwerkdienstkonto ausgeführt würde.
- Eingeschränkter Zugriff (ohne Netzwerkzugang). Ein skriptgesteuerter Task, dem eingeschränkter Zugriff (ohne Netzwerkzugriff) zugewiesen ist, verfügt nicht über umfassenden lokalen Zugriff und kann nicht auf Netzwerkressourcen zugreifen. Wenn diese Option ausgewählt ist, werden der skriptgesteuerten Aufgabe Berechtigungen erteilt, als ob sie unter dem lokalen Dienstkonto ausgeführt wird.
Weitere Informationen finden Sie in der Microsoft-Dokumentation 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 Betriebssystem des Endbenutzers 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%). Falls nicht angegeben,
PSScriptRoot (Englisch)wird als Standardarbeitsordner verwendet. Weitere Informationen zuPSScriptRoot (Englisch), siehe die 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 die von Ihnen hinzugefügte Aufgabe 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:
Ausgabe\report.txt.
Bearbeiten einer skriptgesteuerten Aufgabe
Um eine skriptgesteuerte Aufgabe zu bearbeiten, führen Sie die folgenden Schritte aus:
-
Am Skriptbasierte Aufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld, um schnell nach der Aufgabe zu suchen.
-
Klicken Sie auf die Auslassungspunkte der Aufgabe und wählen Sie dann Aufgabe bearbeiten. Das Bearbeiten einer skriptgesteuerten Aufgabe Assistent wird angezeigt.
-
Am Informationen zur Aufgabe die Einstellungen nach Bedarf konfigurieren.
-
Am Inhalt des Skripts den Skriptinhalt an.
-
Klicken Sie auf Speichern.
Hinweis:
Integrierte skriptgesteuerte Aufgaben können nicht bearbeitet werden.
Löschen einer skriptgesteuerten Aufgabe
Um eine skriptgesteuerte Aufgabe zu löschen, führen Sie die folgenden Schritte aus:
-
Am Skriptbasierte Aufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld, um schnell nach der Aufgabe zu suchen.
-
Klicken Sie auf die Auslassungspunkte der Aufgabe und wählen Sie dann Aufgabe löschen.
Wichtig:
- Integrierte skriptgesteuerte Aufgaben können nicht gelöscht werden.
- Um eine skriptgesteuerte Aufgabe zu löschen, die derzeit für einige Konfigurationssätze aktiviert ist, deaktivieren Sie sie zuerst in diesen Konfigurationssätzen.
Klonen einer skriptgesteuerten Aufgabe
Um eine skriptgesteuerte Aufgabe zu klonen, führen Sie die folgenden Schritte aus:
-
Am Skriptbasierte Aufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld oder Tags, um die Aufgabe schnell zu finden.
-
Klicken Sie auf die Auslassungspunkte der Aufgabe und wählen Sie dann Aufgabe klonen.
Hinweis:
Beim Klonen einer Aufgabe werden Sie aufgefordert, den Namen zu ändern, um doppelte Namen zu vermeiden.
Option “Aufgabeneinstellungen konfigurieren”
Um schnell zur Aufgabeneinstellung zu gelangen, führen Sie die folgenden Schritte aus:
-
Am Skriptbasierte Aufgaben die Aufgabe. Verwenden Sie bei Bedarf das Suchfeld oder Tags, um die Aufgabe schnell zu finden.
-
Klicken Sie auf die Auslassungspunkte der Aufgabe und wählen Sie dann Konfigurieren von Aufgabeneinstellungen.
-
Wählen Sie einen Konfigurationssatz im Feld Konfigurationssatz auswählen Zauberer.
-
Klicken Los , um die gefilterte Aufgabe im Feld Einstellungen für skriptgesteuerte Aufgaben Seite, auf der nur die ausgewählte Aufgabe herausgefiltert wird.
Weitere Informationen
Beispiele für die Verwendung von skriptgesteuerten Aufgaben finden Sie unter: