Remove-JobTrigger

Remove-JobTrigger
    [-InputObject] <ScheduledJobDefinition[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

Remove-JobTrigger
    [-Name] <String[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

Remove-JobTrigger
    [-Id] <Int32[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

O cmdlet Remove-JobTrigger exclui gatilhos de trabalho de trabalhos agendados.

Um gatilho de trabalho define uma agenda recorrente ou condições para iniciar um trabalho agendado. Para gerenciar gatilhos de trabalho, use os cmdlets New-JobTrigger, Add-JobTrigger, Set-JobTrigger e Set-ScheduledJob.

Use os parâmetros Name, IDou InputObject parâmetros de Remove-JobTrigger para identificar os trabalhos agendados dos quais os gatilhos são removidos. Use o parâmetro TriggerID para identificar os gatilhos de trabalho a serem excluídos. Por padrão, Remove-JobTrigger exclui todos os gatilhos de trabalho de um trabalho agendado.

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

PS C:\> Remove-JobTrigger -Name "Test*"

Este comando exclui todos os gatilhos de trabalho do trabalho agendado que têm nomes que começam com Test.

PS C:\> Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Este comando exclui apenas o terceiro gatilho (ID = 3) do trabalho agendado BackupArchive.

PS C:\> function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

Esta função exclui todos os gatilhos de trabalho AtStartup de todos os trabalhos no computador local. Para usar a função, execute a função em sua sessão e digite Delete-AtStartup.

A função Delete-AtStartup contém um único comando. O comando usa o cmdlet Get-ScheduledJob para obter os trabalhos agendados no computador local. Um operador de pipeline (|) envia os trabalhos agendados para o cmdlet Get-JobTrigger, que obtém todos os gatilhos de trabalho de cada um dos trabalhos agendados. Um operador de pipeline envia os gatilhos de trabalho para o cmdlet Where-Object, que seleciona gatilhos de trabalho em que o valor da propriedade Frequency do gatilho de trabalho é igual a AtStartup.

objetos JobTrigger têm uma propriedade JobDefinition que contém o trabalho agendado que eles acionam. O restante do comando usa esse recurso valioso.

Um operador de pipeline envia os gatilhos de trabalho AtStartup para o cmdlet ForEach-Object, que executa um comando Remove-JobTrigger em cada gatilho AtStartup. O valor do parâmetro InputObject de Remove-JobTrigger é o trabalho agendado na propriedade JobDefinition do gatilho de trabalho. O valor do parâmetro TriggerID é o identificador na propriedade ID do gatilho de trabalho.

PS C:\> Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Este comando exclui o primeiro gatilho de trabalho do trabalho de inventário no computador Server01.

O comando usa o cmdlet Invoke-Command para executar o cmdlet Remove-JobTrigger no computador Server01. O cmdlet Remove-JobTrigger usa o parâmetro ID para identificar o trabalho agendado Inventory e o parâmetro TriggerID para especificar o primeiro gatilho. O parâmetro ID é especialmente útil quando vários trabalhos agendados têm nomes iguais ou semelhantes.

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.

Você pode canalizar trabalhos agendados para o cmdlet Remove-JobTrigger.

O cmdlet não gera nenhuma saída.