Partilhar via

Add-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Adiciona acionadores de tarefas a tarefas agendadas.

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 acionadores de tarefas a tarefas agendadas. Pode utilizá-lo para adicionar vários acionadores a várias tarefas agendadas.

Um acionador de tarefa inicia uma tarefa agendada numa agenda única ou periódica ou quando ocorre um evento.

Utilize o parâmetro Acionador de Add-JobTrigger para identificar os acionadores de tarefas a adicionar. Utilize os parâmetros Name, ID ou InputObject de Add-JobTrigger para identificar a tarefa agendada à qual os acionadores 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 tarefas no módulo PSScheduledJob que está incluído no Windows PowerShell.

Para obter mais informações sobre Tarefas Agendadas, veja os tópicos Sobre no módulo PSScheduledJob. Importe o módulo PSScheduledJob e, em seguida, escreva: Get-Help about_Scheduled* ou veja about_Scheduled_Jobs.

Este cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Adicionar um acionador de tarefa a uma tarefa agendada

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

Estes comandos adicionam o acionador tarefa diária à tarefa agendada testJob.

O primeiro comando utiliza o cmdlet New-JobTrigger para criar um acionador de tarefa que inicia uma tarefa agendada todos os dias às 3:00 da manhã. O comando guarda o acionador da tarefa na variável $Daily.

O segundo comando utiliza o cmdlet Add-JobTrigger para adicionar o acionador de tarefa na variável $Startup à tarefa agendada testJob.

Exemplo 2: Adicionar um acionador de tarefa a várias tarefas agendadas

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

Este comando adiciona um acionador de tarefa AtStartup a todas as tarefas agendadas no computador local. Utiliza o Get-ScheduledJob para obter todas as tarefas agendadas no computador. Utiliza um operador de pipeline (|) para enviar as tarefas para o cmdlet Add-JobTrigger , que adiciona o acionador de tarefa a cada uma das tarefas agendadas. O valor do parâmetro Acionador é um comando New-JobTrigger que cria o acionador da tarefa AtStartup.

Exemplo 3: Copiar um acionador de tarefa

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

Estes comandos copiam o acionador da tarefa a partir da tarefa agendada BackupArchives e adicionam-no às tarefas agendadas testBackup e BackupLogs.

O primeiro comando utiliza o cmdlet Get-JobTrigger para obter o acionador da tarefa agendada BackupArchives. O comando guarda o acionador na variável $t.

O segundo comando utiliza o cmdlet Add-JobTrigger para adicionar o acionador de tarefa no $t às tarefas agendadas TestBackup e BackupLogs.

Parâmetros

-Id

Especifica os números de identificação das tarefas agendadas. Add-JobTrigger adiciona o acionador de tarefa às tarefas agendadas especificadas.

Para obter o número de identificação de tarefas agendadas no computador local ou num computador remoto, utilize o cmdlet Get-ScheduledJob.

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

-InputObject

Especifica as tarefas agendadas. Introduza uma variável que contenha objetos ScheduledJob ou escreva um comando ou expressão que obtenha objetos ScheduledJob , como um comando Get-ScheduledJob. Também pode encaminhar 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 das tarefas agendadas. Add-JobTrigger adiciona os acionadores de tarefas às tarefas agendadas especificadas. São suportados carateres universais.

Para obter os nomes das tarefas agendadas no computador local ou num computador remoto, utilize o cmdlet Get-ScheduledJob.

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

-Trigger

Especifica os acionadores de tarefas a adicionar. 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, como um comando Get-JobTrigger. Também pode encaminhar 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

Pode encaminhar acionadores de tarefas ou tarefas agendadas para Add-JobTrigger.

Saídas

None

Este cmdlet não devolve nenhuma saída.