Partilhar via

Add-JobTrigger

Módulo:
PSScheduledJob Module

Adiciona gatilhos de trabalho a trabalhos agendados.

Sintaxe

JobDefinition (Predefinição) 

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, IDou InputObject parâmetros 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 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.

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"

Esses comandos adicionam o gatilho de trabalho diário 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 3h00. 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

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 cmdlet Get-JobTrigger para obter o gatilho de trabalho do trabalho agendado 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-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 dos parâmetros

Tipo:

Int32[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobDefinitionId
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 comando Get-ScheduledJob. Você também pode canalizar objetos ScheduledJob para Add-JobTrigger.

Propriedades dos parâmetros

Tipo:

ScheduledJobDefinition[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobDefinition
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica os nomes dos trabalhos agendados. Add-JobTrigger adiciona os gatilhos de trabalho aos trabalhos agendados especificados. O uso de caracteres universais é suportado.

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobDefinitionName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 de ScheduledJobTrigger ou digite um comando ou expressão que obtenha objetos de ScheduledJobTrigger, como um comando Get-JobTrigger. Você também pode canalizar objetos de ScheduledJobTrigger para Add-JobTrigger .

Propriedades dos parâmetros

Tipo:

ScheduledJobTrigger[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.