Workspace Environment Management

Einstellungen für Skriptaufgaben

Listet alle Skriptaufgaben auf, die auf der Seite Skriptaufgaben verfügbar sind Skriptaufgaben werden auf einer festgelegten Konfigurationsebene ausgeführt. Hier legen Sie fest, welche Skriptaufgaben für den aktuellen Konfigurationssatz aktiviert werden sollen. Um Ihre Skriptaufgaben zu bearbeiten, gehen Sie zu Scripted Tasks.

Konfigurieren einer Skriptaufgabe

  1. Suchen Sie auf der Seite Einstellungen für Skriptaufgaben die Skriptaufgabe, wählen Sie die Ellipse aus, und wählen Sie dann Konfigurierenaus.

  2. Konfigurieren Sie im Assistenten zum Konfigurieren von Skriptaufgaben die folgenden Einstellungen und klicken Sie dann auf Speichern.

Im Allgemeinen:

  • Diese Aufgabe aktivieren. Wählen Sie aus, ob die Aufgabe für den aktuellen Konfigurationssatz aktiviert (Ja) oder deaktiviert (Nein) werden soll. Wenn diese Option deaktiviert ist, verarbeitet der Agent die Aufgabe nicht.
  • Überprüfen Sie die Signatur. Wählen Sie aus, ob die Signatur vor der Ausführung der Aufgabe überprüft werden soll. Die Signaturüberprüfung ist obligatorisch, wenn der Skriptaufgabe vollen Zugriff gewährt wird.
  • Zeitüberschreitung für Aufgaben. Wählen Sie aus, ob ein Timeout (in Minuten) für die Aufgabe festgelegt werden soll. Wenn das Timeout auftritt, muss die Aufgabe zwangsläufig beendet werden. Unterstützte Werte: 1—60. Wir empfehlen, ein Timeout für die Aufgabe festzulegen. Andernfalls wird die Aufgabe möglicherweise weiter ausgeführt, sodass andere Aufgaben nicht ausgeführt werden können.

  • Filtern. Wählen Sie aus, ob die Aufgabe kontextualisiert werden soll, indem Sie einen Filter auswählen. Wenn ein Filter ausgewählt ist, wird dieser Task nur ausgeführt, wenn alle Bedingungen im Filter erfüllt sind. Beachten Sie bei der Auswahl eines Filters Folgendes:

    • Wenn der Filter Bedingungen enthält, die nicht für Skriptaufgaben gelten, überspringt der Agent diese Bedingungen bei der Auswertung des Filters, bevor der Task ausgeführt wird. Eine vollständige Liste der Bedingungen, die nicht für Skriptaufgaben gelten, finden Sie unter Bedingungen, die nicht für Computereinstellungen gelten.

In Triggern:

  • Konfigurieren Sie Trigger für die Aufgabe. Sie können die folgenden Aktionen ausführen:

    • Wählen Sie Trigger aus, die Sie der Aufgabe zuordnen möchten. Wenn diese Trigger aktiviert sind, starten sie die Aufgabe in der Benutzerumgebung.

    • Wählen Sie, ob nur Trigger angezeigt werden sollen, die für diese Aufgabe gelten.

    • Erstellen Sie einen neuen Trigger. Weitere Informationen finden Sie unter Trigger erstellen

    Hinweis:

    Um bestehende Trigger zu bearbeiten, gehen Sie zu Trigger.

In den Parametern:

  • Übergeben Sie Parameter an die Skriptaufgabe. Wählen Sie aus, ob Parameter an die Skriptaufgabe übergeben werden sollen. Wenn diese Option aktiviert ist, können Sie zur Laufzeit Eingaben als Parametervariablen in der Skriptaufgabe bereitstellen. Der Vorteil besteht darin, dass Sie steuern können, wie sich die Skriptaufgabe verhält, ohne den zugrunde liegenden Code zu ändern. Die folgenden Parametertypen sind verfügbar:

    • Ganzzahl. Beispiel: 123.
    • Zeichenfolge. Beispiel: hello world.
    • Boolescher Wert. Richtig oder falsch.
    • Charakter. Beispiel: c.
    • Schalten. Richtig oder falsch.
    • Verdoppeln. Beispiel: 1.023.
    • Datum und Uhrzeit Beispiel: YYYY-MM-DD HH:mm:ss.
    • Dateipfad. Geben Sie einen Pfad ein, den Sie an die Klasse System.IO.FileInfo übergeben möchten. Umgebungsvariablen werden unterstützt. Der Pfad darf die folgenden Zeichen nicht enthalten: * ? < >.

    Hinweis:

    • Sie können bis zu 20 Parameter konfigurieren.
    • Das Feld “Name” ist optional, mit Ausnahme von Parametern vom Typ “Switch”.
    • PowerShell unterstützt teilweise Parameternamen. Wenn Sie einen partiellen Parameternamen verwenden, stellen Sie sicher, dass der Name eindeutig ist — unterscheiden Sie ihn von vorhandenen Parameternamen. Beispiel: Die folgenden Parameternamen sind für PowerShell identisch: -t-ti, und -title. Geben Sie in diesem Fall genügend Buchstaben des Parameternamens ein, um ihn von den anderen Parametern zu unterscheiden.

In Output:

  • Ausgabedateien. Wählen Sie aus, ob Sie Dateien sammeln möchten, die die Aufgabe ausgibt. Falls ausgewählt, wird der Inhalt der Ausgabedatei in Berichte aufgenommen, die für die Aufgabe generiert wurden. Sie können dann den Inhalt der Ausgabedatei in den Berichten anzeigen, ohne auf die Ausgabedateien in der Benutzerumgebung zugreifen zu müssen.

  • Höhepunkte der Ausgabe. Wählen Sie aus, ob Sie bestimmte Inhalte im Inhalt der Ausgabedatei und in der Konsolenausgabe hervorheben möchten.

    • Markieren von Schlüsselwörtern Geben Sie Schlüsselwörter an, die der Bericht hervorheben soll. Sie können mehrere Schlüsselwörter eingeben, die durch Kommas getrennt sind. Nachdem Sie ein Schlüsselwort eingegeben haben, drücken Sie die Eingabetaste , Falls angegeben, werden Berichtsinhalte, die Ihren Schlüsselwörtern entsprechen, in den Abschnitten Ausgabedateiinhalt und Konsolenausgabe in den generierten Berichten hervorgehoben.

    • Markieren Sie Übereinstimmungen mit regulären Ausdrücken. Geben Sie einen regulären Ausdruck ein, der den Inhalt beschreibt, den Sie hervorheben möchten. Der reguläre Ausdruck muss der Syntax der Bibliothek für reguläre .NET-Ausdrücke entsprechen, die PCRE-kompatibel ist. Informationen hierzu finden Sie in der Dokumentation von Microsoft: https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference

      • Regulärer Ausdruck. Geben Sie einen regulären Ausdruck ein, der den Inhalt beschreibt, den Sie hervorheben möchten.
      • Ignoriere Fall. Wählen Sie aus, ob der Inhalt genau zum Fall passen muss.
      • Verwenden Sie den Mehrzeilenabgleich. Wählen Sie aus, ob ein mehrzeiliger Abgleich verwendet werden soll, wobei ^ und $ mit dem Anfang und dem Ende jeder Zeile übereinstimmen, anstatt den Anfang und das Ende des gesamten Ausgabeinhalts.
      • Erfassen Sie nur benannte Gruppen. Wählen Sie, ob nur benannte Gruppen erfasst werden sollen. Erfasste Gruppen werden mithilfe von Klammern im Muster für reguläre Ausdrücke definiert. Benannten Gruppen wird durch die Syntax (?<name> subexpression) explizit ein Name oder eine Zahl zugewiesen.
      • Anzahl der als Kontexthinweise einzubeziehenden Zeilen. Geben Sie die Anzahl der Zeilen vor und nach der Übereinstimmung an, die Sie in die Markierung aufnehmen möchten, als Kontexthinweise. Unterstützte Werte: 1—10.
      • Schließt nur Übereinstimmungen mit regulären Ausdrücken in Berichteein. Steuert, ob der gesamte Ausgabeinhalt in Berichte aufgenommen werden soll oder nur Inhalt, der mit dem regulären Ausdruck übereinstimmt. Durch Aktivieren dieser Option wird die Datenmenge reduziert, die an die Citrix Cloud übertragen wird. Wenn die Option aktiviert ist, hat die Funktion Schlüsselwörter hervorheben unabhängig von den angegebenen Schlüsselwörtern keinen Inhalt zum Anzeigen.
  • Erweiterte Optionen.

    • Sammeln Sie die Ausgabe, auch wenn Laufzeitfehler auftreten. Steuert, ob der Inhalt der Ausgabedatei und die Konsolenausgabe erfasst werden, selbst wenn beim Ausführen der Aufgabe Fehler auftreten.

Berichte für eine Skriptaufgabe anzeigen

Suchen Sie auf der Seite Einstellungen für Skriptaufgaben die Skriptaufgabe, wählen Sie die Ellipse aus, und wählen Sie dann Berichte anzeigenaus. Daraufhin werden Sie zur Seite Überwachung > Berichte weitergeleitet, auf der Sie die Berichte (falls vorhanden) zu der Aufgabe sehen. Klicken Sie auf die Ellipse, um detailliertere Informationen anzuzeigen. Einzelheiten finden Sie unter Berichte.

Einstellungen für Skriptaufgaben