Enable-JobTrigger
Habilita os gatilhos de trabalho de trabalhos agendados.
Sintaxe
Enable-JobTrigger
[-InputObject] <ScheduledJobTrigger[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Enable-JobTrigger reativa gatilhos de trabalho de trabalhos agendados, como aqueles que foram desabilitados usando o cmdlet Disable-JobTrigger. 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 cmdlet 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 cmdlet Enable-JobTrigger 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 veja about_Scheduled_Jobs.
Este 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
Este 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
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}
Este comando reativa 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 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 AtLogon.
Um operador de pipeline envia os gatilhos de trabalho AtLogon para o cmdlet
Exemplo 4: Exibir gatilhos de trabalho desativados
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
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 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 os gatilhos de trabalho desabilitados, ou seja, onde o valor da propriedade Enabled 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
Solicita 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 habilitado. Insira uma variável que contenha objetos ScheduledJobTrigger ou digite um comando ou expressão que obtenha objetos ScheduledJobTrigger, como um comando Get-JobTrigger. Você também pode canalizar um objeto ScheduledJobTrigger para Enable-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: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. 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
Você pode canalizar gatilhos de trabalho para Enable-JobTrigger.
Saídas
None
Este cmdlet não gera nenhuma saída.
Notas
- Enable-JobTrigger não gera erros ou avisos se você habilitar um gatilho de trabalho que já esteja habilitado.
Ligações Relacionadas
- 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