Compartir a través de

Add-JobTrigger

Módulo:
PSScheduledJob Module

Agrega desencadenadores de trabajo a trabajos programados.

Sintaxis

JobDefinition (valor predeterminado) 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-InputObject] <ScheduledJobDefinition[]>
    [<CommonParameters>]

JobDefinitionName 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Name] <String[]>
    [<CommonParameters>]

JobDefinitionId 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Id] <Int32[]>
    [<CommonParameters>]

Description

El cmdlet Add-JobTrigger agrega desencadenadores de trabajo a trabajos programados. Puede usarlo 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 elname de , id.o parámetros 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 cmdlet New-JobTrigger 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 de PSScheduledJob que se incluye en Windows PowerShell.

Para obtener 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

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

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

El primer comando usa el cmdlet New-JobTrigger 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 variable $Daily.

El segundo comando usa el cmdlet Add-JobTrigger 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

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

Ejemplo 3: Copiar un desencadenador de trabajo

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> 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 cmdlet Get-JobTrigger para obtener el desencadenador de trabajo del trabajo programado BackupArchives. El comando guarda el desencadenador en la variable $t.

El segundo comando usa el cmdlet Add-JobTrigger 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 cmdlet Get-ScheduledJob.

Propiedades de parámetro

Tipo:

Int32[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

JobDefinitionId
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 comando Get-ScheduledJob. También puede canalizar objetos ScheduledJob para Add-JobTrigger.

Propiedades de parámetro

Tipo:

ScheduledJobDefinition[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

JobDefinition
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica los nombres de los trabajos programados. Add-JobTrigger agrega los desencadenadores de trabajo a los trabajos programados especificados. Se admiten comodines.

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

JobDefinitionName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 comando Get-JobTrigger. También puede canalizar objetos ScheduledJobTrigger a Add-JobTrigger.

Propiedades de parámetro

Tipo:

ScheduledJobTrigger[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Puede canalizar desencadenadores de trabajo o trabajos programados para Add-JobTrigger.

Salidas

None

Este cmdlet no genera resultados de ningún tipo.