Enable-JobTrigger

Sintaxe

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

Description

O cmdlet Enable-JobTrigger habilita novamente gatilhos de trabalho de trabalhos agendados, como aqueles que foram desabilitados usando o cmdlet Disable-JobTrigger. Gatilhos de trabalho habilitados e habilitados novamente podem iniciar trabalhos agendados imediatamente; não é necessário reiniciar o Windows ou o Windows PowerShell.

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

Para habilitar um gatilho de trabalho, o cmdlet Enable-JobTrigger define a propriedade Habilitada do gatilho de trabalho como $True.

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

Esse cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Habilitar um gatilho de trabalho

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

Esse comando habilita 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 Enable-JobTrigger, que o habilita.

Exemplo 2: Habilitar todos os gatilhos de trabalho

PS C:\> Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

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 dos trabalhos agendados. Outro operador de pipeline envia os gatilhos de trabalho para o cmdlet Enable-JobTrigger, o que os habilita.

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

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

Esse comando habilita novamente os gatilhos de trabalho atLogon no trabalho agendado DeployPackage no computador remoto Server01.

O comando usa o cmdlet Invoke-Command para executar os comandos no computador Server01. O comando remoto usa o cmdlet Get-JobTrigger para obter os gatilhos de trabalho do trabalho agendado do DeployPackage. Um operador de pipeline envia os gatilhos de trabalho para o cmdlet Where-Object que retorna apenas gatilhos de trabalho atLogon. Um operador de pipeline envia os gatilhos de trabalho atLogon para o cmdlet Enable-JobTrigger, o que os habilita.

Exemplo 4: Exibir gatilhos de trabalho desabilitados

PS C:\> Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
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

Esse comando exibe todos os gatilhos de trabalho desabilitados de todos os trabalhos agendados em uma tabela. Você pode usar um comando como este para descobrir gatilhos de trabalho que talvez precisem ser habilitados.

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 dos trabalhos agendados. Outro operador de pipeline envia os gatilhos de trabalho para o cmdlet Where-Object, que retorna apenas gatilhos de trabalho que estão desabilitados, ou seja, em que o valor da propriedade Habilitada do gatilho de trabalho não é (!) verdadeiro.

Outro operador de pipeline envia os gatilhos de trabalho desabilitados para o cmdlet Format-Table, que exibe as propriedades selecionadas dos gatilhos de trabalho em uma tabela. As propriedades incluem uma nova propriedade JobName que exibe o nome do trabalho agendado na propriedade JobDefinition do gatilho de trabalho.

Parâmetros

-Confirm

-InputObject

-PassThru

-WhatIf

Entradas

ScheduledJobTrigger

Você pode canalizar gatilhos de trabalho para Enable-JobTrigger.

Saídas

None

Esse cmdlet não gera nenhuma saída.

Observações

• Enable-JobTrigger não gerará erros ou avisos se você habilitar um gatilho de trabalho que já está habilitado.

Links Relacionados

• about_Scheduled_Jobs
• Add-JobTrigger
• Disable-JobTrigger
• Disable-ScheduledJob
• Enable-JobTrigger
• Enable-ScheduledJob
• Get-JobTrigger
• Get-ScheduledJob
• Get-ScheduledJobOption
• New-JobTrigger
• New-ScheduledJobOption
• Register-ScheduledJob
• Remove-JobTrigger
• Set-JobTrigger
• Set-ScheduledJob
• Set-ScheduledJobOption
• Unregister-ScheduledJob