Disable-JobTrigger

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

O cmdlet Disable-JobTrigger 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 cmdlet 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 cmdlet Disable-JobTrigger define a propriedade Enabled do gatilho de trabalho como $False. Para reativar o gatilho de trabalho, use o cmdlet Enable-JobTrigger, 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 cmdlet Disable-ScheduledJob, 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 cmdlet Start-Job ou usar 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 veja about_Scheduled_Jobs.

Este cmdlet foi introduzido no Windows PowerShell 3.0.

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

Este comando desativa o primeiro gatilho (ID=1) do trabalho agendado Backup-Archives no computador local.

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

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> 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

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

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

Este comando desabilita os gatilhos de trabalho diários no trabalho agendado DeployPackage no computador remoto Server01.

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

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 gatilhos de trabalho para Disable-JobTrigger .

Este cmdlet não gera nenhuma saída.

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