Compartir a través de

Add-JobTrigger

  • Referencia
Módulo:
PSScheduledJob

Agrega desencadenadores de trabajo a los trabajos programados.

Sintaxis

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

Description

El Add-JobTrigger cmdlet agrega desencadenadores de trabajo a trabajos programados. Se puede usar para agregar varios desencadenadores a varios trabajos programados.

Un desencadenador de trabajo inicia un trabajo programado en una programación única o periódica o cuando se produce un evento.

Use el parámetro Trigger de Add-JobTrigger para identificar los desencadenadores de trabajo que se van a agregar. Use los parámetros Name, ID o InputObject de Add-JobTrigger para identificar el trabajo programado al que se agregan los desencadenadores.

Para crear desencadenadores de trabajo para el valor del parámetro Trigger , use el New-JobTrigger cmdlet o use una tabla hash para especificar el desencadenador de trabajo.

Add-JobTrigger 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: Agregar un desencadenador de trabajo a un trabajo programado

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

Estos comandos agregan el desencadenador de trabajo Daily al trabajo programado TestJob.

El primer comando usa el New-JobTrigger cmdlet para crear un desencadenador de trabajo que inicia un trabajo programado todos los días a las 3:00 a.m. El comando guarda el desencadenador de trabajo en la $Daily variable .

El segundo comando usa el Add-JobTrigger cmdlet para agregar el desencadenador de trabajo en la variable $Startup al trabajo programado testJob.

Ejemplo 2: Agregar un desencadenador de trabajo a varios trabajos programados

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Este comando agrega un desencadenador de trabajo AtStartup a todos los trabajos programados en el equipo local. Usa Get-ScheduledJob para obtener todos los trabajos programados en el equipo. Usa un operador de canalización (|) para enviar los trabajos al Add-JobTrigger cmdlet , que agrega el desencadenador de trabajo a cada uno de los trabajos programados. El valor del parámetro Trigger es un New-JobTrigger comando que crea el desencadenador de trabajo AtStartup.

Ejemplo 3: Copiar un desencadenador de trabajo

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Estos comandos copian el desencadenador de trabajo del trabajo programado BackupArchives y lo agregan a los trabajos programados TestBackup y BackupLogs.

El primer comando usa el Get-JobTrigger cmdlet para obtener el desencadenador de trabajo del trabajo programado BackupArchives. El comando guarda el desencadenador en la variable $t.

El segundo comando usa el Add-JobTrigger cmdlet para agregar el desencadenador de trabajo en $t a los trabajos programados TestBackup y BackupLogs.

Parámetros

-Id

Especifica los números de identificación de los trabajos programados. Add-JobTrigger agrega el desencadenador de trabajo a los trabajos programados especificados.

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

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica los trabajos programados. Escriba una variable que contenga objetos ScheduledJob o escriba un comando o expresión que obtenga objetos ScheduledJob, como un Get-ScheduledJob comando. También puede canalizar objetos ScheduledJob a Add-JobTrigger.

Tipo:ScheduledJobDefinition[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica los nombres de los trabajos programados. Add-JobTrigger agrega los desencadenadores de trabajo a los trabajos programados especificados. Se admite caracteres comodín.

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

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Trigger

Especifica los desencadenadores de trabajo que se van a agregar. Escriba una tabla hash que especifique desencadenadores de trabajo o una variable que contenga objetos ScheduledJobTrigger , o escriba un comando o expresión que obtenga objetos ScheduledJobTrigger , como un Get-JobTrigger comando. También puede canalizar objetos ScheduledJobTrigger a Add-JobTrigger.

Tipo:ScheduledJobTrigger[]
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

ScheduledJobTrigger

Puede canalizar un desencadenador de trabajo a este cmdlet.

ScheduledJobDefinition

Puede canalizar un trabajo programado a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.