Compartilhar via

Enable-ScheduledJob

  • Referência
Módulo:
PSScheduledJob

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 habilita novamente os trabalhos agendados que estão desabilitados, como aqueles que são desabilitados usando o Disable-ScheduledJob cmdlet. Trabalhos habilitados são executados automaticamente quando disparados.

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 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 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 a ID 2 no computador local. O parâmetro PassThru permite que o objeto Job seja gerado.

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 os canaliza para o Enable-ScheduledJob cmdlet para habilitá-los.

Enable-ScheduledJob não gera avisos ou erros se você habilitar um trabalho agendado que já esteja 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 agendados nos quais a propriedade RunWithoutNetwork tem um valor de $true. Outro operador de pipeline envia os objetos de opções de trabalho agendados 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 habilita os trabalhos agendados que possuem "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 of Enable-ScheduledJob para habilitar o trabalho agendado de Inventário em cada computador.

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

-Id

Habilita o trabalho agendado com o número de identificação (ID) especificado. Insira a ID de um trabalho agendado.

Tipo:Int32
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Habilita os trabalhos agendados com os nomes especificados. Insira o nome de um trabalho agendado. Há suporte para caracteres curinga.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
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

ScheduledJobDefinition

Você pode canalizar um trabalho agendado para .Enable-ScheduledJob

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

ScheduledJobDefinition

Quando você usa o parâmetro PassThru , esse cmdlet retorna o trabalho agendado que ele habilitou.

Observações

  • Enable-ScheduledJob não gera avisos ou erros se você usá-lo para habilitar um trabalho agendado que já está habilitado.