Enable-ScheduledJob

  • Referência
Módulo:
PSScheduledJob

Habilita um trabalho agendado.

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Habilita os trabalhos agendados com os nomes especificados. Insira o nome de um trabalho agendado. Curingas são suportados.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
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

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 habilitado.

Notas

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