Compartilhar via

Add-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Adiciona disparadores de trabalho a trabalhos agendados.

Sintaxe

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 um agendamento único 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 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 New-JobTrigger cmdlet ou use uma tabela de hash para especificar o gatilho de trabalho.

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

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

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

O primeiro comando usa o New-JobTrigger cmdlet para criar um gatilho de trabalho que inicia um trabalho agendado todos os dias às 3:00 da manhã. O comando salva o gatilho de trabalho na $Daily 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

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 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.

Tipo:Int32[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:ScheduledJobDefinition[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica os nomes dos trabalhos agendados. Add-JobTrigger Adiciona os gatilhos de trabalho aos 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 Get-ScheduledJob cmdlet.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Trigger

Especifica os gatilhos de trabalho a serem adicionados. Insira uma tabela de hash que especifique gatilhos de trabalho ou uma variável que contenha objetos ScheduledJobTrigger ou digite um comando ou expressão que obtenha objetos ScheduledJobTrigger , como um Get-JobTrigger comando. Você também pode canalizar objetos ScheduledJobTrigger para Add-JobTrigger.

Tipo:ScheduledJobTrigger[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

ScheduledJobTrigger

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

ScheduledJobDefinition

Você pode canalizar um trabalho agendado para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.