Disable-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Desativa os acionadores de tarefas de tarefas agendadas.

Syntax

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

O Disable-JobTrigger cmdlet desativa temporariamente os acionadores de tarefas de tarefas agendadas. A desativação preserva todas as propriedades do acionador de tarefas, mas impede que o acionador da tarefa inicie a tarefa agendada.

Para utilizar este cmdlet, utilize o Get-JobTrigger cmdlet para obter os acionadores da tarefa. Em seguida, encaminhe os acionadores da tarefa para Disable-JobTrigger ou utilize o respetivo parâmetro InputObject .

Para desativar um acionador de tarefa, o Disable-JobTrigger cmdlet define a propriedade Ativado do acionador de tarefa como $False. Para reativar o acionador da tarefa, utilize o Enable-JobTrigger cmdlet , que define a propriedade Ativado do acionador de tarefa para $True. Desativar um acionador de tarefa não desativa a tarefa agendada, como é efetuada pelo Disable-ScheduledJob cmdlet, mas se desativar todos os acionadores de tarefas, o efeito é o mesmo que desativar a tarefa agendada.

Se desativar uma tarefa agendada ou desativar todos os acionadores de tarefas de uma tarefa agendada, ainda pode iniciar a tarefa com o Start-Job cmdlet ou utilizar a tarefa agendada desativada como modelo.

Disable-ScheduledJobé 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: Desativar um acionador de tarefa

Este exemplo desativa o primeiro acionador de uma tarefa agendada no computador local.

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

O comando utiliza o Get-JobTrigger cmdlet para obter o acionador da tarefa. Um operador de pipeline (|)envia o acionador de tarefa para o Disable-JobTrigger cmdlet, o que o desativa.

Exemplo 2: Desativar todos os acionadores de tarefas

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

O primeiro comando utiliza o Get-ScheduledJob cmdlet para obter as Backup-Archives tarefas agendadas e Inventário. Um operador de pipeline (|) envia as tarefas agendadas para o Get-JobTrigger cmdlet, que obtém todos os acionadores de tarefas das tarefas agendadas. Outro operador de pipeline envia os acionadores de tarefas para o Disable-JobTrigger cmdlet, o que os desativa. O primeiro comando utiliza o Get-ScheduledJob cmdlet para obter as tarefas, uma vez que o respetivo parâmetro Name utiliza vários nomes.

O segundo comando apresenta os resultados. O comando repete o Get-ScheduledJob comando e Get-JobTrigger . Um operador de pipeline envia os acionadores de tarefas para o Format-Table cmdlet, que apresenta os acionadores da tarefa numa tabela. O Format-Table comando adiciona uma propriedade JobName que apresenta o valor da propriedade Nome da tarefa agendada na propriedade JobDefinition do objeto de acionador de tarefa.

Estes comandos desativam todos os acionadores de tarefas em duas tarefas agendadas e apresentam os resultados.

Exemplo 3: Desativar o acionador de tarefas de uma tarefa agendada num computador remoto

Este exemplo desativa os acionadores de tarefas diárias para uma tarefa agendada num computador remoto

Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

O comando utiliza o Invoke-Command cmdlet para executar os comandos no computador Server01. O comando remoto utiliza o Get-JobTrigger cmdlet para obter os acionadores de tarefas da tarefa agendada DeployPackage. Um operador de pipeline envia os acionadores de tarefas para o Where-Object cmdlet, que devolve apenas acionadores de tarefas diários. Um operador de pipeline envia os acionadores de tarefas diárias para o Disable-JobTrigger cmdlet, o que os desativa.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica o acionador da tarefa a ser desativado. Introduza uma variável que contenha objetos ScheduledJobTrigger ou escreva um comando ou expressão que obtenha objetos ScheduledJobTrigger , como um Get-JobTrigger comando. Também pode encaminhar um objeto ScheduledJobTrigger para Disable-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet não gera quaisquer dados.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Pode encaminhar um acionador de tarefa para este cmdlet.

Saídas

None

Este cmdlet não devolve nenhuma saída.

Notas

  • Disable-JobTrigger não gera erros ou avisos se desativar um acionador de tarefa que já esteja desativado.