Enable-JobTrigger

  • Referência
Módulo:
PSScheduledJob

Habilita os gatilhos de trabalho de trabalhos agendados.

Syntax

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

Description

O Enable-JobTrigger cmdlet reativa gatilhos de trabalho de trabalhos agendados, como aqueles que foram desabilitados usando o Disable-JobTrigger cmdlet. Os gatilhos de trabalho ativados e reativados podem iniciar trabalhos agendados imediatamente; não há necessidade de 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 para Enable-JobTrigger ou 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 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: Habilitar um gatilho de trabalho

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

Este comando habilita o primeiro gatilho (ID=1) do trabalho agendado Backup-Archives 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 cmdlet, o Enable-JobTrigger 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 cmdlet, o Enable-JobTrigger 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 reativa 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 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 AtLogon. Um operador de pipeline envia os gatilhos de trabalho AtLogon para o cmdlet, o Enable-JobTrigger que os habilita.

Exemplo 4: Exibir gatilhos de trabalho desativados

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 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 que estão desabilitados, ou seja, onde 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 a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

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

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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