Partager via

Get-ScheduledJobOption

  • Référence
Module:
PSScheduledJob

Obtient les options de tâche des tâches planifiées.

Syntaxe

Get-ScheduledJobOption
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Id] <Int32>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Name] <String>
   [<CommonParameters>]

Description

L’applet Get-ScheduledJobOption de commande obtient les options de travail des travaux planifiés. Vous pouvez utiliser cette commande pour examiner les options de tâche ou pour les diriger vers d'autres applets de commande.

Les options de tâche ne sont pas enregistrées sur le disque de manière indépendante ; elles font partie d'une tâche planifiée. Pour obtenir les options d'une tâche planifiée, indiquez la tâche planifiée.

Utilisez les paramètres de l’applet Get-ScheduledJobOption de commande pour identifier le travail planifié. Vous pouvez identifier les travaux planifiés par leurs noms ou numéros d’identification, ou en entrant ou en pipissant des objets ScheduledJob, tels que ceux retournés par l’applet Get-ScheduledJob de commande.Get-ScheduledJobOption

Get-ScheduledJobOption 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 : Obtenir les options de travail

Cet exemple obtient les options de travail des travaux planifiés correspondant à un nom spécifié.

Get-ScheduledJobOption -Name "*Backup*"

Exemple 2 : Obtenir toutes les options de travail

Cet exemple obtient les options de travail de tous les travaux planifiés sur l’ordinateur local.

Get-ScheduledJob | Get-ScheduledJobOption

L’exemple utilise l’applet Get-ScheduledJob de commande pour obtenir les travaux planifiés sur l’ordinateur local. 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é.

Exemple 3 : Obtenir les options de travail sélectionnées

Cet exemple montre comment rechercher l'objet d'options de tâche avec des valeurs particulières.

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} |
    ForEach-Object {$_.JobDefinition}

La première commande obtient les options de travail dans lesquelles la propriété RunElevated a la valeur $True et la propriété RunWithoutNetwork a la valeur .$false La sortie affiche l’objet JobOptions sélectionné.

La deuxième commande montre comment rechercher le travail planifié auquel appartiennent les options de travail. Cette commande utilise un opérateur de pipeline (|) pour envoyer les options de travail sélectionnées à l’applet ForEach-Object de commande, qui obtient la propriété JobDefinition de chaque objet options. La propriété JobDefinition contient l’objet de travail d’origine.

Exemple 4 : Utiliser les options de travail pour créer un travail

Cet exemple montre comment utiliser les options de travail qui Get-ScheduledJobOption se présentent dans un nouveau travail planifié.

$Opts = Get-ScheduledJobOption -Name "BackupTestLogs"
Register-ScheduledJob -Name "Archive-Scripts" -FilePath "\\Srv01\Scripts\ArchiveScripts.ps1" -ScheduledJobOption $Opts

La première commande utilise Get-ScheduledJobOption pour obtenir les options de travaux du travail planifié BackupTestLogs. La commande enregistre les options dans la $Opts variable.

La deuxième commande utilise Register-ScheduledJob l’applet de commande pour créer un travail planifié. La valeur du paramètre ScheduledJobOption est l’objet options dans la $Opts variable.

Exemple 5 : Obtenir des options de travail à partir d’un ordinateur distant

$O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

Cette commande utilise l’applet Invoke-Command de commande pour obtenir les options de travail planifiées du travail DataDemon sur l’ordinateur Srv01. La commande enregistre les options dans la $O variable.

Paramètres

-Id

Spécifie le numéro d'identification d'une tâche planifiée. Get-ScheduledJobOption obtient les options de travail du travail planifié spécifié.

Pour obtenir les numéros d’identification des travaux planifiés sur l’ordinateur local ou un ordinateur distant, utilisez l’applet Get-ScheduledJob de commande.

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 une tâche planifiée. Entrez une variable qui contient un objet ScheduledJob ou tapez une commande ou une expression qui obtient un objet ScheduledJob , tel qu’une Get-ScheduledJob commande. Vous pouvez également diriger un objet ScheduledJob vers Get-ScheduledJobOption.

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

Spécifie les noms des tâches planifiées. Get-ScheduledJobOption obtient les options de travail du travail planifié spécifié. Les caractères génériques sont pris en charge.

Pour obtenir les noms des travaux planifiés sur l’ordinateur local ou un ordinateur distant, utilisez l’applet Get-ScheduledJob de commande.

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

Entrées

ScheduledJobDefinition

Vous pouvez diriger un objet de travail planifié vers cette applet de commande.

Sorties

ScheduledJobOptions

Cette applet de commande retourne un objet ScheduledJobOptions .