Partager via

Enable-ScheduledJob

  • Référence
Module:
PSScheduledJob

Active une tâche planifiée.

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 Enable-ScheduledJob de commande réactive les travaux planifiés qui sont désactivés, tels que ceux qui sont désactivés à l’aide de l’applet Disable-ScheduledJob de commande. Les tâches activées s'exécutent automatiquement quand elles sont déclenchées.

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

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

Pour plus d'informations sur les tâches planifiées, consultez les rubriques À propos dans le 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é

Cet exemple active le travail planifié sur un ordinateur local.

Enable-ScheduledJob -ID 2 -PassThru

La Enable-ScheduledJob commande active le travail planifié avec l’ID 2 sur l’ordinateur local. Le paramètre PassThru permet à l’objet Job d’être en sortie.

Exemple 2 : Activer tous les travaux planifiés

Cet exemple active tous les travaux planifiés sur l’ordinateur local.

Get-ScheduledJob | Enable-ScheduledJob

L’applet Get-ScheduledJob de commande obtient tous les travaux planifiés et les dirige vers Enable-ScheduledJob l’applet de commande pour les activer.

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

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

Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} |
    ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

La commande utilise l’applet Get-ScheduledJob de commande pour obtenir tous les travaux planifiés sur l’ordinateur. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet Get-ScheduledJobOption de commande, 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 Where-Object de commande, qui sélectionne les objets d’option de travail planifiés dans lesquels la propriété RunWithoutNetwork a la valeur $true. Un autre opérateur de pipeline envoie les objets d’options de travail planifiées sélectionnés à l’applet ForEach-Object de commande qui exécute une Enable-ScheduledJob commande 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

Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Cette commande active les tâches planifiées dont le nom contient « test » sur deux ordinateurs distants, Srv01 et Srv10.

La commande utilise l’applet Invoke-Command de commande pour exécuter une Enable-ScheduledJob commande 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 demande une confirmation avant d’exécuter la commande cmdlet.

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 la tâche planifiée avec le numéro d'identification (ID) spécifié. Entrez l'ID d'une tâche planifiée.

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 des objets ScheduledJobDefinition ou tapez une commande ou une expression qui obtient des objets ScheduledJobDefinition , tels qu’une Get-ScheduledJob commande. 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 tâches planifiées avec les noms spécifiés. Entrez le nom d'une tâche planifiée. 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 que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. 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

Par défaut, cette applet de commande ne retourne aucune sortie.

ScheduledJobDefinition

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne le travail planifié qu’il a activé.

Notes

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