Add-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Adiciona gatilhos de trabalho a trabalhos agendados.

Syntax

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

Description

O Add-JobTrigger cmdlet 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 para identificar os gatilhos de Add-JobTrigger trabalho a serem adicionados. Use os parâmetros Name, ID ou InputObject para Add-JobTrigger identificar o trabalho agendado ao qual os gatilhos são adicionados.

Para criar acionadores de tarefas do valor do parâmetro Trigger, utilize o cmdlet New-JobTrigger ou utilize uma tabela hash para especificar o acionador da tarefa.

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

Para obter mais informações sobre trabalhos agendados, consulte os tópicos Sobre no 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

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

Esses comandos adicionam o gatilho de trabalho diário ao trabalho agendado TestJob.

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

O segundo comando usa o Add-JobTrigger cmdlet 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

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 Add-JobTrigger cmdlet, que adiciona o gatilho de trabalho a cada um dos trabalhos agendados. O valor do parâmetro Trigger é um New-JobTrigger comando que cria o gatilho de trabalho AtStartup.

Exemplo 3: Copiar um gatilho de trabalho

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

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

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

O segundo comando usa o Add-JobTrigger cmdlet 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-JobTrigger Adiciona o gatilho de trabalho aos trabalhos agendados especificados.

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

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 obtenha objetos ScheduledJob , como um Get-ScheduledJob comando. Você também pode canalizar objetos ScheduledJob para Add-JobTrigger.

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

-Name

Especifica os nomes dos trabalhos agendados. Add-JobTrigger Adiciona os gatilhos de trabalho aos trabalhos agendados especificados. Curingas são suportados.

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

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. Introduza uma tabela hash que especifique os acionadores de tarefas ou uma variável que contenha objetos ScheduledJobTrigger ou escreva um comando ou expressão que obtenha objetos ScheduledJobTrigger, tal como um comando Get-JobTrigger. Você também pode canalizar objetos ScheduledJobTrigger para Add-JobTrigger.

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

Entradas

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Você pode canalizar um gatilho de trabalho para esse cmdlet.

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Você pode canalizar um trabalho agendado para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.