Compartir a través de

Enable-ScheduledJob

  • Referencia
Módulo:
PSScheduledJob

Habilita un trabajo programado.

Sintaxis

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

El Enable-ScheduledJob cmdlet vuelve a habilitar los trabajos programados que están deshabilitados, como los que están deshabilitados mediante el Disable-ScheduledJob cmdlet . Los trabajos habilitados se ejecutan automáticamente cuando se desencadenan.

Para habilitar un trabajo programado, el Enable-ScheduledJob cmdlet establece la propiedad Enabled del trabajo programado en $true.

Enabled-ScheduledJob es una de una colección de cmdlets de programación de trabajos en el módulo PSScheduledJob que se incluye en Windows PowerShell.

Para más información sobre los trabajos programados, vea los temas Acerca de en el módulo PSScheduledJob. Importe el módulo PSScheduledJob y escriba: Get-Help about_Scheduled* o vea about_Scheduled_Jobs.

Este cmdlet se introdujo en Windows PowerShell 3.0.

Ejemplos

Ejemplo 1: Habilitar un trabajo programado

En este ejemplo se habilita el trabajo programado en un equipo local.

Enable-ScheduledJob -ID 2 -PassThru

El Enable-ScheduledJob comando habilita el trabajo programado con el identificador 2 en el equipo local. El parámetro PassThru permite que el objeto Job sea de salida.

Ejemplo 2: Habilitar todos los trabajos programados

En este ejemplo se habilitan todos los trabajos programados en el equipo local.

Get-ScheduledJob | Enable-ScheduledJob

El Get-ScheduledJob cmdlet obtiene todos los trabajos programados y los canaliza al Enable-ScheduledJob cmdlet para habilitarlos.

Enable-ScheduledJob no genera advertencias ni errores si habilita un trabajo programado que ya está habilitado, por lo que puede habilitar todos los trabajos programados sin condiciones.

Ejemplo 3: Habilitar trabajos programados seleccionados

En este ejemplo se habilitan los trabajos programados que no requieren una conexión de red.

Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} |
    ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

El comando usa el Get-ScheduledJob cmdlet para obtener todos los trabajos programados en el equipo. Un operador de canalización (|) envía los trabajos programados al Get-ScheduledJobOption cmdlet , que obtiene las opciones de trabajo de cada trabajo programado. Cada objeto de opciones de trabajo tiene una propiedad JobDefinition que contiene el trabajo programado asociado. La propiedad JobDefinition se usa para completar el comando.

El comando usa un operador de canalización (|) para enviar las opciones de trabajo al Where-Object cmdlet , que selecciona objetos de opción de trabajo programados en los que la propiedad RunWithoutNetwork tiene un valor de $true. Otro operador de canalización envía los objetos de opciones de trabajo programados seleccionados al ForEach-Object cmdlet que ejecuta un Enable-ScheduledJob comando en el trabajo programado en el valor de la propiedad JobDefinition de cada objeto de opciones de trabajo.

Ejemplo 4: Habilitar trabajos programados en un equipo remoto

Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Este comando habilita los trabajos programados que tienen "test" en sus nombres en dos equipos remotos, Srv01 y Srv10.

El comando usa el Invoke-Command cmdlet para ejecutar un Enable-ScheduledJob comando en los equipos Srv01 y Srv10. El comando usa el parámetro Name de Enable-ScheduledJob para habilitar el trabajo programado inventario en cada equipo.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Habilita el trabajo programado con el número de identificación especificado. Escriba el identificador de un trabajo programado.

Tipo:Int32
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica el trabajo programado que se va a habilitar. Escriba una variable que contenga objetos ScheduledJobDefinition o escriba un comando o expresión que obtenga objetos ScheduledJobDefinition , como un Get-ScheduledJob comando. También puede canalizar un objeto ScheduledJobDefinition a Enable-ScheduledJob.

Tipo:ScheduledJobDefinition
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Habilita los trabajos programados con los nombres especificados. Escriba el nombre de un trabajo programado. Se admite caracteres comodín.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

ScheduledJobDefinition

Puede canalizar un trabajo programado a Enable-ScheduledJob.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

ScheduledJobDefinition

Cuando se usa el parámetro PassThru , este cmdlet devuelve el trabajo programado que ha habilitado.

Notas

  • Enable-ScheduledJob no genera advertencias ni errores si se usa para habilitar un trabajo programado que ya está habilitado.