Partager via

Enable-ScheduledJob

  • Référence
Module:
PSScheduledJob

Active un travail planifié.

Syntaxe

Enable-ScheduledJob
      [-InputObject] <ScheduledJobDefinition>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-ScheduledJob
      [-Id] <Int32>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-ScheduledJob
      [-Name] <String>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Enable-ScheduledJob réactive les travaux planifiés désactivés, tels que ceux qui sont désactivés à l’aide de l’applet de commande Disable-ScheduledJob. Les travaux activés s’exécutent automatiquement lorsqu’ils sont déclenchés.

Pour activer un travail planifié, l’applet de commande Enable-ScheduledJob définit la propriété Enabled du travail planifié sur $True.

Enabled-ScheduledJob est une collection d’applets de commande de planification de travaux dans le module PSScheduledJob inclus dans Windows PowerShell.

Pour plus d’informations sur les travaux planifiés, consultez les rubriques À propos du module PSScheduledJob. Importez le module PSScheduledJob, puis tapez : Get-Help about_Scheduled* ou consultez about_Scheduled_Jobs.

Cette applet de commande a été introduite dans Windows PowerShell 3.0.

Exemples

Exemple 1 : Activer un travail planifié

PS C:\> Enable-ScheduledJob -ID 2 -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True

Cette commande active le travail planifié avec l’ID 2 sur l’ordinateur local. La sortie affiche l’effet de la commande.

Exemple 2 : Activer tous les travaux planifiés

PS C:\> Get-ScheduledJob | Enable-ScheduledJob -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        True
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     True
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       True

Cette commande active tous les travaux planifiés sur l’ordinateur local. Il utilise l’applet de commande Get-ScheduledJob pour obtenir tout le travail planifié et l’applet de commande Enable-ScheduledJob pour les activer.

l' Enable-ScheduledJob ne génère pas d’avertissements ou d’erreurs si vous activez un travail planifié déjà activé. Vous pouvez donc activer tous les travaux planifiés sans conditions.

Exemple 3 : Activer les travaux planifiés sélectionnés

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} | ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

Cette commande active les travaux planifiés qui ne nécessitent pas de connexion réseau.

La commande utilise l’applet de commande Get-ScheduledJob pour obtenir tous les travaux planifiés sur l’ordinateur. Un opérateur de pipeline envoie les travaux planifiés à l’applet de commande Get-ScheduledJobOption, qui obtient les options de travail de chaque travail planifié. Chaque objet d’options de travail a une propriété JobDefinition qui contient le travail planifié associé. La propriété JobDefinition est utilisée pour terminer la commande.

La commande utilise un opérateur de pipeline (|) pour envoyer les options de travail à l’applet de commande Where-Object, qui sélectionne les objets d’option de travail planifiés dans lesquels la propriété RunWithoutNetwork a la valeur True ($true). Un autre opérateur de pipeline envoie les objets d’options de travail planifiées sélectionnés à l’applet de commande ForEach-Object qui exécute une commande Enable-ScheduledJob sur le travail planifié dans la valeur de la propriété JobDefinition de chaque objet d’options de travail.

Exemple 4 : Activer les travaux planifiés sur un ordinateur distant

PS C:\> Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Cette commande active les travaux planifiés qui ont des « tests » dans leurs noms sur deux ordinateurs distants, Srv01 et Srv10.

La commande utilise l’applet de commande Invoke-Command pour exécuter une commande Enable-ScheduledJob sur les ordinateurs Srv01 et Srv10. La commande utilise le paramètre Name de Enable-ScheduledJob pour activer le travail planifié d’inventaire sur chaque ordinateur.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Active le travail planifié avec le numéro d’identification (ID) spécifié. Entrez l’ID d’un travail planifié.

Type:Int32
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie le travail planifié à activer. Entrez une variable qui contient ScheduledJobDefinition objets ou tapez une commande ou une expression qui obtient ScheduledJobDefinition objets, tels qu’une commande Get-ScheduledJob. Vous pouvez également diriger un objet ScheduledJobDefinition vers Enable-ScheduledJob.

Type:ScheduledJobDefinition
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Active les travaux planifiés avec les noms spécifiés. Entrez le nom d’un travail planifié. Les caractères génériques sont pris en charge.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

ScheduledJobDefinition

Vous pouvez diriger un travail planifié vers Enable-ScheduledJob.

Sorties

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Si vous utilisez le paramètre Passthru , Enable-ScheduledJob retourne le travail planifié activé. Sinon, cette applet de commande ne génère aucune sortie.

Notes

  • l' Enable-ScheduledJob ne génère pas d’avertissements ou d’erreurs si vous l’utilisez pour activer un travail planifié déjà activé.