Compartilhar via

Add-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Adiciona disparadores de trabalho a trabalhos agendados.

Syntax

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

Description

O cmdlet Add-JobTrigger adiciona gatilhos de trabalho a trabalhos agendados. Você pode usá-lo para adicionar vários gatilhos a vários trabalhos agendados.

Um gatilho de trabalho inicia um trabalho agendado em uma agenda única ou recorrente ou quando ocorre um evento.

Use o parâmetro Trigger de Add-JobTrigger para identificar os gatilhos de trabalho a serem adicionados. Use os parâmetros Name, ID ou InputObject de Add-JobTrigger para identificar o trabalho agendado ao qual os gatilhos são adicionados.

Para criar gatilhos de trabalho para o valor do parâmetro Trigger , use o cmdlet New-JobTrigger ou use uma tabela de hash para especificar o gatilho de trabalho.

Add-JobTrigger é uma de uma coleção de cmdlets de agendamento de trabalho no módulo PSScheduledJob incluído em Windows PowerShell.

Para obter mais informações sobre trabalhos agendados, consulte os tópicos sobre o módulo PSScheduledJob. Importe o módulo PSScheduledJob e digite: Get-Help about_Scheduled* ou consulte about_Scheduled_Jobs.

Este cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Adicionar um gatilho de trabalho a um trabalho agendado

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

Estes comandos adicionam o gatilho de trabalho Daily ao trabalho agendado TestJob.

O primeiro comando usa o cmdlet New-JobTrigger para criar um gatilho de trabalho que inicia um trabalho agendado todos os dias às 3h. O comando salva o gatilho de trabalho na variável $Daily.

O segundo comando usa o cmdlet Add-JobTrigger para adicionar o gatilho de trabalho na variável $Startup ao trabalho agendado TestJob.

Exemplo 2: Adicionar um gatilho de trabalho a vários trabalhos agendados

PS C:\> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Este comando adiciona um gatilho de trabalho AtStartup a todos os trabalhos agendados no computador local. Ele usa o Get-ScheduledJob para obter todos os trabalhos agendados no computador. Ele usa um operador de pipeline (|) para enviar os trabalhos para o cmdlet Add-JobTrigger, que adiciona o gatilho de trabalho a cada um dos trabalhos agendados. O valor do parâmetro Trigger é um comando New-JobTrigger que cria o gatilho de trabalho AtStartup.

Exemplo 3: Copiar um gatilho de trabalho

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Estes comandos copiam o gatilho de trabalho do trabalho agendado BackupArchives e adicionam-no aos trabalhos agendados TestBackup e BackupLogs.

O primeiro comando usa o cmdlet Get-JobTrigger para obter o gatilho de trabalho do trabalho agendado do BackupArchives. O comando salva o gatilho na variável $t.

O segundo comando usa o cmdlet Add-JobTrigger para adicionar o gatilho de trabalho em $t aos trabalhos agendados TestBackup e BackupLogs.

Parâmetros

-Id

Especifica os números de identificação dos trabalhos agendados. Add-JobTriggeradiciona o gatilho de trabalho a trabalhos agendados especificados.

Para obter o número de identificação de trabalhos agendados no computador local ou em um computador remoto, use o cmdlet Get-ScheduledJob.

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

-InputObject

Especifica os trabalhos agendados. Insira uma variável que contenha objetos ScheduledJob ou digite um comando ou expressão que obtém objetos ScheduledJob , como um comando Get-ScheduledJob. Você também pode canalizar objetos ScheduledJob para Add-JobTrigger.

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

-Name

Especifica os nomes dos trabalhos agendados. Add-JobTriggeradiciona os gatilhos de trabalho a trabalhos agendados especificados. Há suporte para caracteres curinga.

Para obter os nomes dos trabalhos agendados no computador local ou em um computador remoto, use o cmdlet Get-ScheduledJob.

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

-Trigger

Especifica os gatilhos de trabalho a serem adicionados. Insira uma tabela de hash que especifica gatilhos de trabalho ou uma variável que contenha objetos ScheduledJobTrigger ou digite um comando ou expressão que obtém objetos ScheduledJobTrigger , como um comando Get-JobTrigger. Você também pode canalizar objetos ScheduledJobTrigger para 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

É possível redirecionar gatilhos de trabalho ou trabalhos agendados para Add-JobTrigger.

Saídas

None

Este cmdlet não retorna nenhuma saída.