Planifications
Planifiez l'exécution de scripts dans PowerShell Universal.
Attribuez des planifications aux scripts pour définir la fréquence et d'autres paramètres, tels que les informations d'identification d'exécution.
Les planifications sont stockées dans le fichier de configuration schedules.ps1.
Planifier une tâche
Pour planifier une tâche, accédez à la page Automation / Planifications et cliquez sur le bouton Nouvelle planification. Pour planifier un script, accédez à la page du script et cliquez sur Planifier.
Vous pouvez définir des planifications à partir de sélections simples telles que Chaque minute ou Chaque heure, ou vous pouvez définir vous-même des expressions CRON pour des planifications plus configurables. Vous pouvez également créer des planifications Unique qui s'exécutent une seule fois à une date ultérieure.
Vous pouvez également définir sous quel utilisateur la tâche planifiée s'exécute, ainsi que la version de PowerShell utilisée.
Planifications simples
Les planifications simples sont en réalité des assistants pour diverses planifications CRON standard. 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.
Voici quelques exemples d'expressions CRON de base.
* * * * *
Chaque minute
0 0 1 * *
À minuit, le 1er de chaque mois
*/5 * * * *
Toutes les 5 minutes
30,45-15/2 1 * * *
Toutes les 2 minutes de 1h00 à 1h15 et de 1h45 à 1h59, ainsi qu'à 1h30
0 0 * * MON-FRI
À 00h00, du lundi au vendredi
Unique
Les planifications uniques s'exécutent une seule fois dans le futur. Vous pouvez sélectionner l'heure et le jour auxquels elles s'exécuteront.
Continue
Les planifications continues s'exécutent en boucle. Vous pouvez définir un délai entre chaque exécution de la 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 passer une valeur à ce paramètre lors de 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 depuis PowerShell, vous pouvez définir les paramètres sur le cmdlet New-PSUSchedule. Ce cmdlet accepte une table de hachage représentant les paramètres du script, ce qui vous permet de passer 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, l'environnement par défaut est utilisé. Vous pouvez définir un environnement dans l'interface utilisateur à l'aide de la liste déroulante Environnement. Vous pouvez définir un environnement à l'aide du paramètre -Environment dans New-PSUSchedule.
Exécuter en tant que
Vous pouvez définir sous quel utilisateur exécuter la planification à l'aide du sélecteur Exécuter en tant que dans l'interface utilisateur. Ce sélecteur 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 informations d'identification de l'utilisateur qui exécute PowerShell Universal.
Vous pouvez définir un utilisateur Exécuter en tant que dans un script à l'aide du paramètre -Credential. La valeur doit être le nom de la variable qui contient vos informations d'identification.
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 doit être exécutée. Cela est utile si vous utilisez les mêmes scripts de référentiel 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 ne s'exécute que s'il existe une variable d'environnement nommée Slot contenant la valeur production.
Mise en pause des planifications
Vous pouvez mettre en pause une planification en définissant la propriété Paused. Lorsqu'une planification est mise en pause, elle ne s'exécute pas. Cela est utile pour arrêter l'exécution d'une planification 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 correspond au nombre de minutes avant l'annulation de la tâche planifiée.
Délai aléatoire
La propriété Délai aléatoire entraîne le démarrage d'une planification entre 0 et 60 secondes à partir de l'heure planifiée. Cela est utile lorsque de nombreuses planifications s'exécutent en même temps. Par exemple, si vous avez 10 planifications qui démarrent à minuit, vous pouvez définir un délai aléatoire pour limiter la contention de ressources sur le service PowerShell Universal.
Disponible dans la branche
Dans les environnements multi-branches, il peut être nécessaire d'éviter l'exécution de planifications en fonction de la branche chargée dans PowerShell Universal. Vous pouvez utiliser l'option -AvailableInBranch sur New-PSUSchedule pour éviter qu'une planification s'exécute dans une certaine branche. Cette valeur est également disponible dans la console d'administration sous les paramètres de planification lorsque git est activé.
API
Mis à jour
Ce contenu vous a-t-il été utile ?