Partager via

Disable-ScheduledJob

  • Référence
Module:
PSScheduledJob

Désactive une tâche planifiée.

Syntaxe

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

Description

L’applet Disable-ScheduledJob de commande désactive temporairement les travaux planifiés. La désactivation conserve toutes les propriétés des tâches et ne désactive pas les déclencheurs de tâche, mais elle empêche les tâches planifiées de démarrer automatiquement lors du déclenchement. Vous pouvez démarrer un travail planifié désactivé à l’aide de l’applet Start-Job de commande ou utiliser un travail planifié désactivé comme modèle.

Pour désactiver un travail planifié, l’applet Disable-ScheduledJob de commande définit la propriété Enabled du travail planifié sur False. Pour réactiver le travail planifié, utilisez l’applet Enable-ScheduledJob de commande.

Disable-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 : Désactiver un travail planifié

Cet exemple désactive un travail planifié sur l’ordinateur local.

Disable-ScheduledJob -ID 2 -PassThru

Cette commande désactive la tâche planifiée avec l'ID 2 sur l'ordinateur local.

Exemple 2 : Désactiver tous les travaux planifiés

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

Get-ScheduledJob | Disable-ScheduledJob -PassThru

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        False
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     False
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       False

L’applet Get-ScheduledJob de commande pour obtenir tous les travaux planifiés et les canaliser vers l’applet Disable-ScheduledJob de commande pour les désactiver.

Vous pouvez réactiver le travail planifié à l’aide de l’applet Enable-ScheduledJob de commande et exécuter un travail planifié désactivé à l’aide de l’applet Start-Job de commande.

Disable-ScheduledJob ne génère pas d’avertissements ou d’erreurs si vous désactivez un travail planifié déjà désactivé. Vous pouvez donc désactiver tous les travaux planifiés sans conditions.

Exemple 3 : Désactiver les travaux planifiés sélectionnés

Cet exemple désactive le travail planifié n’inclut pas d’informations d’identification.

Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

Les tâches sans informations d'identification s'exécutent avec l'autorisation de l'utilisateur qui les a créées.

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 Where-Object de commande, qui sélectionne les travaux planifiés qui n’ont pas d’informations d’identification. La commande utilise l’opérateur non (!) et fait référence à la propriété Credential du travail planifié. Un autre opérateur de pipeline envoie les travaux planifiés sélectionnés à l’applet Disable-ScheduledJob de commande, ce qui les désactive.

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

Cet exemple désactive un travail planifié sur deux ordinateurs distants.

Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

La commande utilise l’applet Invoke-Command de commande pour exécuter une Disable-ScheduledJob commande sur les ordinateurs Srv01 et Srv10. La commande utilise le paramètre Name de Disable-ScheduledJob pour sélectionner la tâche planifiée TestJob sur chaque ordinateur.

Exemple 5 : Désactiver un travail planifié par son ID global

Cet exemple montre comment désactiver une tâche planifiée à l'aide de son identificateur global. La valeur de la propriété GlobalID d'une tâche planifiée est un identificateur unique (GUID). Utilisez la valeur GlobalID quand la précision est requise, par exemple quand vous désactivez des tâches planifiées sur plusieurs ordinateurs.

Get-ScheduledJob | Format-Table -Property Name, GlobalID, Command -Autosize

Name             GlobalId                             Command
----             --------                             -------
ArchiveProjects1 a26a0b3d-b4e6-44d3-8b95-8706ef621f7c C:\Scripts\Archive-DxProjects.ps1
Inventory        3ac37e5d-84c0-4a8f-9661-7e88ebb8f914 \\Srv01\Scripts\Get-FullInventory.ps1
Backup-Scripts   4d0cc6be-c082-48d1-baec-1bd8278f3c81  Copy-Item C:\CurrentScripts\*.ps1 -Destination C:\BackupScripts
Test-HelpFiles   d77020ca-f20d-42be-86c8-fc64df97db90 .\Test-HelpFiles.ps1
Test-HelpFiles   2f1606d2-c6cf-4bef-8b1c-ae36a9cc9934 .\Test-DomainHelpFiles.ps1

Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

La première commande illustre une façon de trouver l’ID global d’un travail planifié. La commande utilise l’applet Get-ScheduledJob de commande pour obtenir les travaux planifiés sur l’ordinateur. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet Format-Table de commande, qui affiche les propriétés Name, GlobalID et Command de chaque travail d’une table.

La deuxième commande utilise l’applet Get-ScheduledJob de commande pour obtenir les travaux planifiés sur l’ordinateur. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet Where-Object de commande, qui sélectionne le travail planifié avec l’ID global spécifié. Un autre opérateur de pipeline envoie le travail à l’applet Disable-ScheduledJob de commande, ce qui le désactive.

Paramètres

-Confirm

Vous demande une confirmation 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

Désactive 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 la tâche planifiée à désactiver. 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 Disable-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

Désactive 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 Disable-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é désactivé.

Notes

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