about_Scheduled_Jobs_Basics

Artículo
04/13/2023

Descripción breve

Explica cómo crear y administrar los trabajos programados.

Descripción larga

En este documento se muestra cómo realizar tareas básicas de creación y administración de trabajos programados. Para obtener información sobre las tareas más avanzadas, consulte about_Scheduled_Jobs_Advanced.

Para obtener más información sobre los cmdlets incluidos en el módulo PSScheduledJob , consulte PSScheduledJob.

Creación de un trabajo programado

Para crear un trabajo programado, use el Register-ScheduledJob cmdlet . El cmdlet requiere un nombre y los comandos o script que ejecuta el trabajo. Puede ejecutar el trabajo inmediatamente agregando el parámetro RunNow , o bien crear un desencadenador de trabajo y establecer opciones de trabajo al crear el trabajo o editar un trabajo existente.

Para crear un trabajo que ejecute un script, use el parámetro FilePath para especificar la ruta de acceso al archivo de script. Para crear un trabajo que ejecute comandos, use el parámetro ScriptBlock .

El Register-ScheduledJob cmdlet crea processJob, que ejecuta un Get-Process comando. Este trabajo programado tiene las opciones de trabajo predeterminadas y ningún desencadenador de trabajo.

Register-ScheduledJob -Name ProcessJob -ScriptBlock { Get-Process }

Id         Name            Triggers        Command       Enabled
--         ----            --------        -------       -------
8          ProcessJob      {}              Get-Process   True

Creación de un desencadenador de trabajo

Los desencadenadores de trabajo inician automáticamente un trabajo programado. Un desencadenador de trabajo puede ser una programación única o periódica o un evento, como cuando un usuario inicia sesión o Windows. Cada trabajo puede tener cero, uno o varios desencadenadores de trabajo.

Para crear un desencadenador de trabajo, use el New-JobTrigger cmdlet . El comando siguiente crea un desencadenador de trabajo que inicia un trabajo todos los lunes y jueves a las 5:00 a. m. El comando guarda el desencadenador de trabajo en la $T variable .

$T = New-JobTrigger -Weekly -DaysOfWeek "Monday", "Thursday" -At "5:00 AM"

Los desencadenadores de trabajo son opcionales. Puede iniciar un trabajo programado en cualquier momento agregando el parámetro RunNow al Register-ScheduledJob comando o mediante los Start-Job cmdlets .

Adición de un desencadenador de trabajo

Al agregar un desencadenador de trabajo a un trabajo programado, el desencadenador de trabajo se agrega al archivo XML del trabajo programado para el trabajo programado y se convierte en parte del trabajo programado.

Puede agregar un desencadenador de trabajo a un trabajo programado al crear el trabajo programado o editar un trabajo existente. Puede cambiar el desencadenador de trabajo de un trabajo programado en cualquier momento.

PowerShell usa algunos de los mismos desencadenadores de trabajo que usa el Programador de tareas. Para obtener información detallada sobre los desencadenadores de trabajos, consulte el tema de ayuda del cmdlet New-JobTrigger .

En el Register-ScheduledJob ejemplo siguiente se usa la expansión para crear $JobParms los valores de parámetro que se pasan al cmdlet . Para obtener más información, consulte about_Splatting.md. Register-ScheduledJob usa @JobParms para crear un trabajo programado. Usa el parámetro Trigger para especificar el desencadenador de trabajo en la $T variable .

$JobParms = @{
  Name = "ProcessJob"
  ScriptBlock = {Get-Command}
  Trigger = $T
}

Register-ScheduledJob @JobParms

También puede agregar un desencadenador de trabajo a un trabajo programado existente en cualquier momento. El Add-JobTrigger cmdlet agrega el desencadenador de trabajo en la $T variable al trabajo programado processJob .

Add-JobTrigger -Name ProcessJob -Trigger $T

Como resultado, el desencadenador de trabajo inicia processJob automáticamente todos los lunes y jueves a las 5:00 a. m.

Obtención de un desencadenador de trabajo

Para obtener el desencadenador de trabajo de un trabajo programado, use el Get-JobTrigger cmdlet . Use los parámetros Name, ID y InputObject para especificar el trabajo programado, no el desencadenador de trabajo.

Get-JobTrigger obtiene el desencadenador de trabajo de ProcessJob.

Get-JobTrigger -Name ProcessJob

Id   Frequency       Time                   DaysOfWeek              Enabled
--   ---------       ----                   ----------              -------
1    Weekly          11/7/2011 5:00:00 AM   {Monday, Thursday}      True

Creación de opciones de trabajo

Las opciones de trabajo establecen condiciones para iniciar y ejecutar el trabajo. Cada trabajo tiene las opciones de trabajo predeterminadas a menos que las cambie. Dado que las opciones de trabajo pueden impedir que un trabajo se ejecute en el momento programado, es importante comprender las opciones de trabajo y usarlas cuidadosamente.

PowerShell usa las mismas opciones de trabajo que usa el Programador de tareas. Para obtener información detallada sobre las opciones de trabajo, consulte el tema de ayuda de New-ScheduledJobOption.

Las opciones de trabajo se almacenan en el archivo XML del trabajo programado. Puede establecer opciones de trabajo al crear un trabajo programado o cambiarlas en cualquier momento.

El New-ScheduledJobOption cmdlet crea una opción de trabajo programada en la que la opción de trabajo programado WakeToRun está establecida en True. La opción WakeToRun ejecuta el trabajo programado incluso si el equipo está en estado Suspensión o Hibernación en la hora de inicio programada. El comando guarda las opciones de trabajo en la $O variable .

$O = New-ScheduledJobOption -WakeToRun

Obtención de opciones de trabajo

Para obtener las opciones de trabajo de un trabajo programado, use el Get-ScheduledJobOption cmdlet . Use los parámetros Name, ID y InputObject para especificar el trabajo programado, no las opciones de trabajo.

Get-ScheduledJobOption obtiene las opciones de trabajo de ProcessJob.

Get-ScheduledJobOption -Name ProcessJob

StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : False
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNew
JobDefinition          : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Cómo cambiar las opciones de trabajo

Puede cambiar las opciones de trabajo de un trabajo programado al crear un trabajo programado o editar un trabajo existente.

La expansión $JobParms se pasa al Add-JobTrigger cmdlet para crear el trabajo de proceso. Usa el parámetro ScheduledJobOption para especificar las opciones de trabajo en la $O variable .

$JobParms = @{
  Name = "ProcessJob"
  ScriptBlock = {Get-Process}
  ScheduledJobOption = $O
}

Add-JobTrigger @JobParms

También puede cambiar las opciones de trabajo a un trabajo programado existente en cualquier momento. El siguiente comando usa el Set-ScheduledJobOption cmdlet para cambiar el valor de la opción WakeToRun de ProcessJob scheduledJob a True.

Los Set cmdlets del módulo PSScheduledJob , como el Set-ScheduledJobOption cmdlet , no tienen parámetros Name o ID . Puede usar el parámetro InputObject para especificar las opciones de trabajo programadas o canalizar un trabajo programado del Get-ScheduledJobOption cmdlet a Set-ScheduledJobOption.

En este ejemplo se usa el Get-ScheduledJob cmdlet para obtener ProcessJob. Usa el Get-ScheduledJobOption cmdlet para obtener las opciones de trabajo en ProcessJob y el Set-ScheduledJobOption cmdlet para cambiar la opción de trabajo WakeToRun en ProcessJob a True.

Get-ScheduledJob -Name ProcessJob | Get-ScheduledJobOption |
 Set-ScheduledJobOption -WakeToRun

Obtención de instancias de trabajo programadas

Cuando se inicia un trabajo programado, PowerShell crea una instancia de trabajo similar a un trabajo en segundo plano de PowerShell estándar. Puede usar los cmdlets de trabajo, como Get-Job, Stop-Job y Receive-Job para administrar las instancias de trabajo.

Nota:

Para usar los cmdlets de trabajo en instancias de trabajos programados, el módulo PSScheduledJob debe importarse en la sesión. Para importar el módulo PSScheduledJob , escriba Import-Module PSScheduledJob o use cualquier cmdlet de trabajo programado, como Get-ScheduledJob.

Para obtener todas las instancias de trabajos programados de PowerShell y todos los trabajos estándar activos, use el Get-Job cmdlet . El Import-Module cmdlet importa el módulo PSScheduledJob y Get-Job obtiene los trabajos en el equipo local.

Import-Module PSScheduledJob
Get-Job

Get-Job obtiene instancias de ProcessJob en el equipo local.

Get-Job -Name ProcessJob

Id     Name        PSJobTypeName  State    HasMoreData   Location   Command
--     ----        ------------   -----    -----------   --------   -------
45     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
46     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
47     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
48     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
49     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
50     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
51     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process

La pantalla predeterminada no muestra la hora de inicio, que normalmente distingue las instancias del mismo trabajo programado.

El Get-Job cmdlet envía objetos a la canalización. El Format-Table cmdlet muestra las propiedades Name, ID y BeginTime del trabajo programado.

Get-Job ProcessJob | Format-Table -Property Name, ID, BeginTime

Name       Id BeginTime
----       -- ---------
ProcessJob 43 11/2/2011 3:00:02 AM
ProcessJob 44 11/3/2011 3:00:02 AM
ProcessJob 45 11/4/2011 3:00:02 AM
ProcessJob 46 11/5/2011 3:00:02 AM
ProcessJob 47 11/6/2011 3:00:02 AM
ProcessJob 48 11/7/2011 12:00:01 AM
ProcessJob 49 11/7/2011 3:00:02 AM
ProcessJob 50 11/8/2011 3:00:02 AM

Obtención de resultados de trabajos programados

Para obtener los resultados de una instancia de un trabajo programado, use el Receive-Job cmdlet .

Nota:

Para usar los cmdlets job en instancias de trabajos programados, el módulo PSScheduledJob debe importarse en la sesión. Para importar el módulo PSScheduledJob , escriba Import-Module PSScheduledJob o use cualquier cmdlet de trabajo programado, como Get-ScheduledJob.

En este ejemplo se obtienen los resultados de la instancia más reciente del trabajo programado ProcessJob (ID = 51).

Import-Module PSScheduledJob
Receive-Job -ID 51 -Keep

Los resultados de los trabajos programados se guardan en el disco, por lo que el parámetro Keep de Receive-Job no es necesario. Sin embargo, sin el parámetro Keep , puede obtener los resultados de un trabajo programado solo una vez en cada sesión de PowerShell. Para iniciar una nueva sesión de PowerShell, escriba PowerShell o abra una nueva ventana de PowerShell.