Compartilhar via

Add-JobTrigger

Módulo:
PSScheduledJob Module

Adiciona gatilhos de trabalho a trabalhos agendados.

Sintaxe

JobDefinition (Default) 

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

JobDefinitionName 

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

JobDefinitionId 

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 é 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 veja about_Scheduled_Jobs.

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

Esses comandos adicionam o gatilho de trabalho Diário ao trabalho agendado de 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 de TestJob.

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

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

Esse 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 gatilho é 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

Esses comandos copiam o gatilho de trabalho do trabalho agendado do BackupArchives e o adicionam aos trabalhos agendados de 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 de 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 cmdlet Get-ScheduledJob.

Propriedades do parâmetro

Tipo:

Int32[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

JobDefinitionId
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 redirecionar objetos scheduledJob para Add-JobTrigger.

Propriedades do parâmetro

Tipo:

ScheduledJobDefinition[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

JobDefinition
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 de trabalhos agendados no computador local ou em um computador remoto, use o cmdlet Get-ScheduledJob.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

JobDefinitionName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 redirecionar objetos ScheduledJobTrigger para Add-JobTrigger.

Propriedades do parâmetro

Tipo:

ScheduledJobTrigger[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

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

Você pode canalizar gatilhos de trabalho ou trabalhos agendados para Add-JobTrigger .

Saídas

None

Este cmdlet não retorna nenhuma saída.