For the complete documentation index, see llms.txt. This page is also available as Markdown.

Zeitpläne

Weisen Sie Skripten Zeitpläne zu, um die Häufigkeit und andere Parameter für ein Skript festzulegen, wie z. B. die Anmeldeinformationen für die Ausführung.

Zeitpläne werden in der Konfigurationsdatei schedules.ps1 gespeichert.

Einen Job planen

Um einen Job zu planen, gehen Sie zur Seite Automatisierung / Zeitpläne und klicken Sie auf die Schaltfläche Neuer Zeitplan. Um ein Skript zu planen, gehen Sie zur Seite des Skripts und klicken Sie auf Planen.

Sie können Zeitpläne basierend auf einfachen Auswahlmöglichkeiten wie Jede Minute oder Jede Stunde definieren, oder Sie können CRON-Ausdrücke selbst definieren, um besser konfigurierbare Zeitpläne zu erstellen. Sie können auch einmalige Zeitpläne ausführen, die einmal zu einem späteren Zeitpunkt laufen.

Sie können auch festlegen, unter welchem Benutzer der geplante Job ausgeführt wird und welche PowerShell-Version er verwendet.

Einfache Zeitpläne

Einfache Zeitpläne sind eigentlich nur Hilfen für verschiedene Standard-CRON-Zeitpläne. Wenn Sie einen auswählen, wird ein CRON-Zeitplan für Ihr Skript definiert.

CRON

CRON-Zeitpläne verwenden CRON-Ausdrücke, um Zeitpläne zu definieren. PowerShell Universal nutzt eine Bibliothek namens Cronos. Weitere Beispiele für gültige Ausdrücke finden Sie hier.

Einige Beispiele für einfache CRON-Ausdrücke sind unten aufgeführt.

Ausdruck
Beschreibung

* * * * *

Jede Minute

0 0 1 * *

Um Mitternacht, am 1. Tag jedes Monats

*/5 * * * *

Alle 5 Minuten

30,45-15/2 1 * * *

Alle 2 Minuten von 1:00 Uhr bis 1:15 Uhr und von 1:45 Uhr bis 1:59 Uhr und um 1:30 Uhr

0 0 * * MON-FRI

Um 00:00, Montag bis Freitag

Einmalig

Einmalige Zeitpläne werden einmal in der Zukunft ausgeführt. Sie können die Uhrzeit und den Tag der Ausführung auswählen.

Kontinuierlich

Kontinuierliche Zeitpläne werden immer wieder ausgeführt. Sie können eine Verzögerung zwischen den einzelnen geplanten Job-Ausführungen festlegen.

Parameter

Zeitpläne unterstützen das Festlegen von Parametern für Skripte. Wenn Sie beispielsweise ein Skript haben, das einen Parameter akzeptiert, können Sie wählen, während des Zeitplans einen Wert an den Parameter zu übergeben.

Innerhalb des Modals zur Definition des Zeitplans können Sie den Parameterwert festlegen.

Beim Bearbeiten von Zeitplänen über PowerShell können Sie die Parameter im Cmdlet New-PSUSchedule definieren. Dieses Cmdlet akzeptiert eine Hashtabelle, die die Parameter des Skripts darstellt, sodass Sie die Werte für Ihren Zeitplan übergeben können.

Umgebungen

Beim Erstellen eines Zeitplans können Sie die Umgebung angeben, in der Ihr Job ausgeführt werden soll. Standardmäßig wird die Standardumgebung verwendet. Sie können eine Umgebung in der Benutzeroberfläche über das Dropdown-Menü Umgebung definieren. Sie können eine Umgebung mit dem Parameter -Environment in New-PSUSchedule definieren.

Ausführen als

Sie können festlegen, als welcher Benutzer der Zeitplan ausgeführt wird, indem Sie den Auswähler „Ausführen als“ in der Benutzeroberfläche verwenden. Der Auswähler „Ausführen als“ enthält eine Liste der von Ihnen definierten PSCredential-Variablen. Sie müssen eine PSCredential-Variable definieren, bevor der Auswähler „Ausführen als“ sichtbar ist. Standardmäßig werden geplante Jobs unter den Anmeldeinformationen des Benutzers ausgeführt, der PowerShell Universal ausführt.

Sie können einen „Ausführen als“-Benutzer in einem Skript mit dem Parameter -Credential definieren. Der Wert sollte der Name der Variablen sein, die Ihre Anmeldeinformationen enthält.

Computer

Sie können den Computer oder die Computer auswählen, auf denen der Zeitplan ausgeführt werden soll. Standardmäßig werden Zeitpläne auf jedem verfügbaren Computer ausgeführt. Wenn Sie Alle Computer auswählen, wird der Zeitplan auf allen mit dem PSU-Cluster verbundenen Computern ausgeführt. Wenn Sie einen bestimmten Computer auswählen, wird der Zeitplan nur auf diesem Computer ausgeführt.

Bedingungen

Sie können Bedingungen definieren, die bestimmen, ob ein Zeitplan ausgeführt werden soll. Dies ist nützlich, wenn Sie dieselben Repository-Skripte für mehrere Umgebungen verwenden. Derzeit können Bedingungen nicht in der Admin-Konsole definiert werden. Bedingungen werden dem aktuellen Skript und Zeitplan als Parameter übergeben. Der Bedingungs-Scriptblock wird innerhalb der integrierten Umgebung ausgeführt.

Die Bedingung muss true oder false zurückgeben. Unten sehen Sie ein Beispiel für eine Bedingung, bei der der Zeitplan nur ausgeführt wird, wenn eine Umgebungsvariable namens Slot vorhanden ist, die den Wert production enthält.

Zeitpläne pausieren

Sie können einen Zeitplan pausieren, indem Sie die Eigenschaft Pausiert setzen. Wenn ein Zeitplan pausiert ist, wird er nicht ausgeführt. Dies ist nützlich, um die Ausführung eines Zeitplans zu stoppen, ohne ihn zu löschen.

Zeitüberschreitung

Sie können eine Zeitüberschreitung für geplante Jobs festlegen. Die Zeitüberschreitung ist die Anzahl der Minuten, bevor der geplante Job abgebrochen wird.

Zufällige Verzögerung

Die Eigenschaft „Zufällige Verzögerung“ bewirkt, dass ein Zeitplan zwischen 0 und 60 Sekunden nach der geplanten Zeit startet. Dies ist nützlich, wenn viele Zeitpläne gleichzeitig ausgeführt werden. Wenn Sie beispielsweise 10 Zeitpläne haben, die um Mitternacht starten, möchten Sie möglicherweise eine zufällige Verzögerung festlegen, um Ressourcenkonflikte beim PowerShell Universal-Dienst zu begrenzen.

In Branch verfügbar

In Umgebungen mit mehreren Branches kann es notwendig sein, die Ausführung von Zeitplänen basierend auf dem in PowerShell Universal geladenen Branch zu vermeiden. Sie können die Option -AvailableInBranch in New-PSUSchedule verwenden, um zu verhindern, dass ein Zeitplan ausgeführt wird, wenn ein bestimmter Branch ausgeführt wird. Dieser Wert ist auch in der Admin-Konsole unter den Zeitplan-Einstellungen verfügbar, wenn Git aktiviert ist.

In Branch verfügbar

API

Zuletzt aktualisiert

War das hilfreich?