Enable-ScheduledJob
Habilita um trabalho agendado.
Sintaxe
Enable-ScheduledJob
[-InputObject] <ScheduledJobDefinition>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Enable-ScheduledJob
[-Id] <Int32>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Enable-ScheduledJob
[-Name] <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O Enable-ScheduledJob
cmdlet reativa trabalhos agendados que estão desabilitados, como aqueles que são desabilitados usando o Disable-ScheduledJob
cmdlet. Os trabalhos habilitados são executados automaticamente quando acionados.
Para habilitar um trabalho agendado, o Enable-ScheduledJob
cmdlet define a propriedade Enabled do trabalho agendado como $true
.
Enabled-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 trabalho agendado
Este exemplo habilita o trabalho agendado em um computador local.
Enable-ScheduledJob -ID 2 -PassThru
O Enable-ScheduledJob
comando habilita o trabalho agendado com ID 2 no computador local. O parâmetro PassThru permite que o objeto Job seja produzido.
Exemplo 2: Habilitar todos os trabalhos agendados
Este exemplo habilita todos os trabalhos agendados no computador local.
Get-ScheduledJob | Enable-ScheduledJob
O Get-ScheduledJob
cmdlet obtém todos os trabalhos agendados e canaliza-os para o Enable-ScheduledJob
cmdlet para habilitá-los.
Enable-ScheduledJob
não gera avisos ou erros se você habilitar um trabalho agendado que já está habilitado, para que você possa habilitar todos os trabalhos agendados sem condições.
Exemplo 3: Habilitar trabalhos agendados selecionados
Este exemplo habilita trabalhos agendados que não exigem uma conexão de rede.
Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} |
ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}
O comando usa o Get-ScheduledJob
cmdlet para obter todos os trabalhos agendados no computador. Um operador de pipeline (|
) envia os trabalhos agendados para o Get-ScheduledJobOption
cmdlet, que obtém as opções de trabalho de cada trabalho agendado. Cada objeto de opções de trabalho tem uma propriedade JobDefinition que contém o trabalho agendado associado. A propriedade JobDefinition é usada para concluir o comando.
O comando usa um operador de pipeline (|
) para enviar as opções de trabalho para o Where-Object
cmdlet, que seleciona objetos de opção de trabalho agendado nos quais a propriedade RunWithoutNetwork tem um valor de $true
. Outro operador de pipeline envia os objetos de opções de trabalho agendado selecionados para o ForEach-Object
cmdlet, que executa um Enable-ScheduledJob
comando no trabalho agendado no valor da propriedade JobDefinition de cada objeto de opções de trabalho.
Exemplo 4: Habilitar trabalhos agendados em um computador remoto
Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}
Este comando permite trabalhos agendados que têm "teste" em seus nomes em dois computadores remotos, Srv01 e Srv10.
O comando usa o Invoke-Command
cmdlet para executar um Enable-ScheduledJob
comando nos computadores Srv01 e Srv10. O comando usa o parâmetro Name de para habilitar o trabalho agendado de Enable-ScheduledJob
Inventário em cada computador.
Parâmetros
-Confirm
Solicita a sua 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 |
-Id
Habilita o trabalho agendado com o número de identificação (ID) especificado. Insira o ID de um trabalho agendado.
Tipo: | Int32 |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-InputObject
Especifica o trabalho agendado a ser habilitado. Insira uma variável que contenha objetos ScheduledJobDefinition ou digite um comando ou expressão que obtenha objetos ScheduledJobDefinition , como um Get-ScheduledJob
comando. Você também pode canalizar um objeto ScheduledJobDefinition para Enable-ScheduledJob
.
Tipo: | ScheduledJobDefinition |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Name
Habilita os trabalhos agendados com os nomes especificados. Insira o nome de um trabalho agendado. Curingas são suportados.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
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: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. 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 um trabalho agendado para Enable-ScheduledJob
.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru , esse cmdlet retorna o trabalho agendado habilitado.
Notas
Enable-ScheduledJob
não gera avisos ou erros se você usá-lo para habilitar um trabalho agendado que já está habilitado.
Ligações Relacionadas
- 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