Partilhar via

Disable-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Desabilita os gatilhos de trabalho de trabalhos agendados.

Sintaxe

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

Description

O Disable-JobTrigger cmdlet desabilita temporariamente os gatilhos de trabalho de trabalhos agendados. A desativação preserva todas as propriedades do gatilho de trabalho, mas impede que o gatilho de trabalho inicie o trabalho agendado.

Para usar esse cmdlet, use-o Get-JobTrigger para obter os gatilhos de trabalho. Em seguida, canalize os gatilhos de trabalho para Disable-JobTrigger ou use seu parâmetro InputObject .

Para desabilitar um gatilho de trabalho, o Disable-JobTrigger cmdlet define a propriedade Enabled do gatilho de trabalho como $False. Para reativar o gatilho de trabalho, use o Enable-JobTrigger cmdlet, que define a propriedade Enabled do gatilho de trabalho como $True. A desativação de um gatilho de trabalho não desabilita o trabalho agendado, como é feito pelo Disable-ScheduledJob cmdlet, mas se você desabilitar todos os gatilhos de trabalho, o efeito será o mesmo que desabilitar o trabalho agendado.

Se você desabilitar um trabalho agendado ou desabilitar todos os gatilhos de trabalho de um trabalho agendado, ainda poderá iniciá-lo usando o Start-Job cmdlet ou o trabalho agendado desabilitado como modelo.

Disable-ScheduledJob é 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 consulte about_Scheduled_Jobs.

Este cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Desativar um gatilho de trabalho

Este exemplo desabilita o primeiro disparador de um trabalho agendado no computador local.

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

O comando usa o Get-JobTrigger cmdlet para obter o gatilho de trabalho. Um operador de pipeline (|)envia o gatilho de trabalho para o cmdlet, o Disable-JobTrigger que o desabilita.

Exemplo 2: Desativar todos os gatilhos de trabalho

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 usa o Get-ScheduledJob cmdlet para obter os trabalhos agendados e Backup-Archives Inventário. Um operador de pipeline (|) envia os trabalhos agendados para o Get-JobTrigger cmdlet, que obtém todos os gatilhos de trabalho dos trabalhos agendados. Outro operador de pipeline envia os gatilhos de trabalho para o cmdlet, o Disable-JobTrigger que os desabilita. O primeiro comando usa o Get-ScheduledJob cmdlet para obter os trabalhos, porque seu parâmetro Name usa vários nomes.

O segundo comando exibe os resultados. O comando repete o Get-ScheduledJob comando and Get-JobTrigger . Um operador de pipeline envia os gatilhos de trabalho para o Format-Table cmdlet, que exibe os gatilhos de trabalho em uma tabela. O Format-Table comando adiciona uma propriedade JobName que exibe o valor da propriedade Name do trabalho agendado na propriedade JobDefinition do objeto de gatilho de trabalho.

Esses comandos desabilitam todos os gatilhos de trabalho em dois trabalhos agendados e exibem os resultados.

Exemplo 3: Desativar o gatilho de trabalho de um trabalho agendado em um computador remoto

Este exemplo desabilita os gatilhos de trabalho diário para um trabalho agendado em um computador remoto

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

O comando usa o Invoke-Command cmdlet para executar os comandos no computador Server01. O comando remote usa o Get-JobTrigger cmdlet para obter os gatilhos de trabalho do trabalho agendado DeployPackage. Um operador de pipeline envia os gatilhos de trabalho para o Where-Object cmdlet, que retorna apenas gatilhos de trabalho diários. Um operador de pipeline envia os gatilhos de trabalho diários para o cmdlet, o Disable-JobTrigger que os desabilita.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Especifica o gatilho de trabalho a ser desabilitado. Insira uma variável que contenha objetos ScheduledJobTrigger ou digite um comando ou expressão que obtenha objetos ScheduledJobTrigger , como um Get-JobTrigger comando. Você também pode canalizar um objeto ScheduledJobTrigger para Disable-JobTrigger.

Tipo:ScheduledJobTrigger[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

ScheduledJobTrigger

Você pode canalizar um gatilho de trabalho para esse cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

  • Disable-JobTrigger não gera erros ou avisos se você desabilitar um gatilho de trabalho que já esteja desativado.