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

Planifications

Attribuez des planifications aux scripts pour définir la fréquence et d'autres paramètres d'un script, comme les identifiants d'exécution.

Les planifications sont stockées dans le fichier de configuration schedules.ps1.

Planifier une tâche

Pour planifier une tâche, allez à la page Automatisation / Planifications et cliquez sur le bouton Nouvelle planification. Pour planifier un script, allez à la page du script et cliquez sur Planifier.

Vous pouvez définir des planifications basées sur des sélections simples comme Chaque minute ou Chaque heure, ou vous pouvez définir vous-même des expressions CRON pour des planifications plus configurables. Vous pouvez aussi exécuter des planifications Une seule fois qui s'exécutent une fois à une date ultérieure.

Vous pouvez aussi définir sous quel utilisateur la tâche planifiée s'exécute, ainsi que la version de PowerShell qu'elle utilise.

Planifications simples

Les planifications simples ne sont en réalité que des aides pour diverses planifications CRON standards. Lorsque vous en sélectionnez une, elle définit une planification CRON pour votre script.

CRON

Les planifications CRON utilisent des expressions CRON pour définir les planifications. PowerShell Universal tire parti d'une bibliothèque appelée Cronos. Pour plus d'exemples d'expressions valides, cliquez ici.

Quelques exemples d'expressions CRON de base sont présentés ci-dessous.

Expression
Description

* * * * *

Chaque minute

0 0 1 * *

À minuit, le 1er jour de chaque mois

*/5 * * * *

Toutes les 5 minutes

30,45-15/2 1 * * *

Toutes les 2 minutes de 1:00 AM à 01:15 AM et de 1:45 AM à 1:59 AM et à 1:30 AM

0 0 * * MON-FRI

À 00:00, du lundi au vendredi

Une seule fois

Les planifications Une seule fois s'exécuteront une fois dans le futur. Vous pouvez sélectionner l'heure et le jour de leur exécution.

Continue

Les planifications continues s'exécutent encore et encore. Vous pouvez définir un délai entre chaque exécution de tâche planifiée.

Paramètres

Les planifications prennent en charge la définition de paramètres pour les scripts. Par exemple, si vous avez un script qui accepte un paramètre, vous pouvez choisir de transmettre une valeur au paramètre pendant la planification.

Dans la fenêtre modale de définition de la planification, vous pouvez définir la valeur du paramètre.

Lors de la modification des planifications à partir de PowerShell, vous pouvez définir les paramètres sur l'applet de commande New-PSUSchedule. Cette applet de commande accepte une table de hachage représentant les paramètres du script afin que vous puissiez transmettre les valeurs pour votre planification.

Environnements

Lors de la création d'une planification, vous pouvez spécifier l'environnement dans lequel votre tâche s'exécutera. Par défaut, elle utilisera l'environnement par défaut. Vous pouvez définir un environnement dans l'interface utilisateur en utilisant la liste déroulante Environnement. Vous pouvez définir un environnement en utilisant le paramètre -Environment dans New-PSUSchedule.

Exécuter en tant que

Vous pouvez définir sous quel utilisateur exécuter la planification en utilisant le sélecteur Exécuter en tant que dans l'interface utilisateur. Le sélecteur Exécuter en tant que contient une liste de variables PSCredential que vous avez définies. Vous devez définir une variable PSCredential avant que le sélecteur Exécuter en tant que soit visible. Par défaut, les tâches planifiées s'exécutent sous les identifiants de l'utilisateur qui exécute PowerShell Universal.

Vous pouvez définir un utilisateur Exécuter en tant que dans un script en utilisant le paramètre -Credential. La valeur devrait être le nom de la variable qui contient votre identifiant.

Ordinateur

Vous pouvez sélectionner l'ordinateur ou les ordinateurs sur lesquels exécuter la planification. Par défaut, les planifications s'exécutent sur n'importe quel ordinateur disponible. Si vous sélectionnez Tous les ordinateurs, la planification s'exécute sur tous les ordinateurs connectés au cluster PSU. Si vous sélectionnez un ordinateur spécifique, la planification s'exécute uniquement sur cet ordinateur.

Conditions

Vous pouvez définir des conditions qui déterminent si une planification devrait être exécutée. C'est utile si vous utilisez les mêmes scripts de dépôt pour plusieurs environnements. Actuellement, les conditions ne peuvent pas être définies dans la console d'administration. Les conditions sont transmises au script et à la planification actuels en tant que paramètres. Le bloc de script de condition s'exécute dans l'environnement intégré.

La condition doit retourner vrai ou faux. Voici un exemple de condition où la planification s'exécute uniquement s'il existe une variable d'environnement nommée Slot qui contient la valeur production.

Mettre les planifications en pause

Vous pouvez mettre une planification en pause en définissant la propriété Pausé. Lorsqu'une planification est en pause, elle ne s'exécute pas. C'est utile pour empêcher une planification de s'exécuter sans la supprimer.

Délai d'expiration

Vous pouvez définir un délai d'expiration pour les tâches planifiées. Le délai d'expiration est le nombre de minutes avant que la tâche planifiée soit annulée.

Délai aléatoire

La propriété Délai aléatoire fait qu'une planification démarre entre 0 et 60 secondes après l'heure planifiée. C'est utile lors de l'exécution de plusieurs planifications en même temps. Par exemple, si vous aviez 10 planifications qui démarrent à minuit, vous pourriez vouloir définir un délai aléatoire pour limiter la contention des ressources sur le service PowerShell Universal.

Disponible dans la branche

Dans les environnements à branches multiples, il peut être nécessaire d'éviter d'exécuter des planifications selon la branche qui est chargée dans PowerShell Universal. Vous pouvez utiliser l'option -AvailableInBranch sur New-PSUSchedule pour éviter qu'une planification s'exécute lors de l'exécution dans une certaine branche. Cette valeur est aussi disponible dans la console d'administration sous les paramètres de la planification lorsque git est activé.

Disponible dans la branche

API

Mis à jour

Ce contenu vous a-t-il été utile ?