Compartir a través de

Get-ScheduledJobOption

  • Referencia
Módulo:
PSScheduledJob

Obtiene las opciones de trabajo de los trabajos programados.

Syntax

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

Description

El cmdlet Get-ScheduledJobOption obtiene las opciones de trabajo de los trabajos programados. Este comando se puede usar para examinar las opciones de trabajo o para canalizar las opciones del trabajo a otros cmdlets.

Las opciones de trabajo no se guardan en el disco de forma independiente; forman parte de un trabajo programado. Para obtener las opciones de trabajo de un trabajo programado, especifique el trabajo programado en cuestión.

Use los parámetros del cmdlet Get-ScheduledJobOption para identificar el trabajo programado. Puede identificar los trabajos programados por sus nombres o números de identificación, o si escribe o canaliza objetos ScheduledJob , como los devueltos por el cmdlet Get-ScheduledJob, a Get-ScheduledJobOption.

Get-ScheduledJobOption es una de una colección de cmdlets de programación de trabajos en el módulo PSScheduledJob que se incluye en Windows PowerShell.

Para más información sobre los trabajos programados, vea los temas Acerca de en el módulo PSScheduledJob. Importe el módulo PSScheduledJob y escriba: Get-Help about_Scheduled* o vea about_Scheduled_Jobs.

Este cmdlet se introdujo en Windows PowerShell 3.0.

Ejemplos

Ejemplo 1: Obtener opciones de trabajo

PS C:\> Get-ScheduledJobOption -Name "*Backup*"
StartIfOnBatteries     : False

StopIfGoingOnBatteries : True

WakeToRun              : False

StartIfNotIdle         : True

StopIfGoingOffIdle     : False

RestartOnIdleResume    : False

IdleDuration           : 00:10:00

IdleTimeout            : 01:00:00

ShowInTaskScheduler    : True

RunElevated            : True

RunWithoutNetwork      : True

DoNotAllowDemandStart  : False

MultipleInstancePolicy : Ignore

NewJobDefinition       : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Este comando obtiene las opciones de trabajo de los trabajos programados que tienen BackUp en sus nombres. Los resultados muestran el objeto de opciones de trabajo que Get-ScheduledJobOption ha devuelto.

Ejemplo 2: Obtener todas las opciones de trabajo

PS C:\> Get-ScheduledJob | Get-ScheduledJobOptions

Este comando obtiene las opciones de trabajo de todos los trabajos programados en el equipo local.

Usa el cmdlet Get-ScheduledJob para obtener los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados al cmdlet Get-ScheduledJobOptions, que obtiene las opciones de trabajo de cada trabajo programado.

Ejemplo 3: Obtener opciones de trabajo seleccionadas

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}
StartIfOnBatteries     : False

StopIfGoingOnBatteries : True

WakeToRun              : True

StartIfNotIdle         : True

StopIfGoingOffIdle     : False

RestartOnIdleResume    : False

IdleDuration           : 00:10:00

IdleTimeout            : 01:00:00

ShowInTaskScheduler    : True

RunElevated            : True

RunWithoutNetwork      : True

DoNotAllowDemandStart  : False

MultipleInstancePolicy : Ignore

NewJobDefinition       : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

The second command shows how to find to which scheduled job the job options belong. This command uses a pipeline operator (|) to send the selected job options to the ForEach-Object cmdlet, which gets the JobDefinition property of each options object. The JobDefinition property contains the originating job object. The results show that the selected options came from the DeployPkg scheduled job.
PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} | ForEach-Object {$_.JobDefinition}
Id         Name            Triggers        Command                                  Enabled

--         ----            --------        -------                                  -------

2          DeployPkg         {1, 2}        DeployPackage.ps1                        True

En este ejemplo se muestra cómo encontrar un objeto de opciones de trabajo con valores concretos.

El primer comando obtiene las opciones de trabajo en las que la propiedad RunElevated tiene un valor de $True y la propiedad RunWithoutNetwork tiene un valor de $False. La salida muestra el objeto JobOptions seleccionado.

Ejemplo 4: Uso de opciones de trabajo para crear un nuevo trabajo

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

En este ejemplo se muestra cómo usar las opciones de trabajo que Get-ScheduledJobOptions obtiene en un nuevo trabajo programado.

El primer comando usa Get-ScheduledJobOptions para obtener las opciones de trabajo del trabajo programado BackupTestLogs. El comando guarda las opciones en la variable $Opts.

El segundo comando usa Register-ScheduledJob cmdlet para crear un nuevo trabajo programado. El valor del parámetro ScheduledJobOption es el objeto de opciones en la variable $Opts.

Ejemplo 5: Obtener opciones de trabajo desde un equipo remoto

PS C:\> $O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

Este comando usa el cmdlet Invoke-Command para obtener las opciones de trabajo programadas del trabajo DataDemon en el equipo Srv01. El comando guarda las opciones en la variable $O.

Parámetros

-Id

Especifica el número de identificación de un trabajo programado. Get-ScheduledJobOptionobtiene las opciones de trabajo del trabajo programado especificado.

Para obtener los números de identificación de trabajos programados en el equipo local o en un equipo remoto, use el cmdlet Get-ScheduledJob.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica un trabajo programado Escriba una variable que contenga un objeto ScheduledJob o escriba un comando o expresión que obtenga un objeto ScheduledJob , como un comando Get-ScheduledJob. También se puede canalizar un objeto ScheduledJob a Get-ScheduledJobOption.

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica los nombres de los trabajos programados. Get-ScheduledJobOptionobtiene las opciones de trabajo del trabajo programado especificado. Se admite caracteres comodín.

Para obtener los nombres de los trabajos programados en el equipo local o en un equipo remoto, use el cmdlet Get-ScheduledJob.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

ScheduledJobDefinition

Puede canalizar un trabajo programado de Get-ScheduledJob a Get-ScheduledJobOption.

Salidas

ScheduledJobOptions