Compartilhar via

Enable-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Habilita os disparadores de trabalho dos trabalhos agendados.

Sintaxe

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

Description

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

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

Para habilitar um gatilho de trabalho, o Enable-JobTrigger cmdlet define a propriedade Enabled 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 o 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: Habilitar um gatilho de trabalho

Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

Este comando habilita o primeiro gatilho (ID = 1) de trabalho agendado de arquivos de backup no computador local.

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

Exemplo 2: Habilitar todos os gatilhos de trabalho

Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

O comando usa o Get-ScheduledJob cmdlet para obter os trabalhos agendados no computador local. 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 Enable-JobTrigger cmdlet, que os habilita.

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

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

Este comando reabilita os gatilhos de trabalho AtLogon no trabalho agendado DeployPackage no computador remoto Server01.

O comando usa o Invoke-Command cmdlet para executar os comandos no computador Server01. O comando remoto 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 AtLogon. Um operador de pipeline envia os gatilhos de trabalho AtLogon para o Enable-JobTrigger cmdlet, que os habilita.

Exemplo 4: Exibir gatilhos de trabalho desabilitados

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

Este 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 os gatilhos de trabalho que talvez precisem ser habilitados.

O comando usa o Get-ScheduledJob cmdlet para obter os trabalhos agendados no computador local. 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 Where-Object cmdlet, que retorna apenas os gatilhos de trabalho desabilitados, ou seja, em que o valor da propriedade Enabled do gatilho de trabalho não é (!) true.

Outro operador de pipeline envia os gatilhos de trabalho desabilitados para o Format-Table cmdlet, 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

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica o gatilho de trabalho a ser habilitado. 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 Enable-JobTrigger.

Tipo:ScheduledJobTrigger[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

ScheduledJobTrigger

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

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

  • Enable-JobTrigger não gera erros ou avisos se você ativar um gatilho de trabalho que já esteja ativado.