Add-JobTrigger

Referencia

Módulo:: PSScheduledJob

Agrega desencadenadores de trabajo a los trabajos programados.

Syntax

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

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

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

Description

El cmdlet Add-JobTrigger 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 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 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

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

Estos comandos agregan el desencadenador de trabajo Daily 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.

Type:	Int32[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 a Add-JobTrigger.

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. 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 cmdlet Get-ScheduledJob.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	ScheduledJobTrigger[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

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

Se pueden canalizar desencadenadores de trabajo o trabajos programados a Add-JobTrigger.

Salidas

None

Este cmdlet no genera resultados de ningún tipo.