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

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

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

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

Para obtener 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

PS C:\> Enable-ScheduledJob -ID 2 -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True

Este comando habilita el trabajo programado con el identificador 2 en el equipo local. La salida muestra el efecto del comando.

Ejemplo 2: Habilitar todos los trabajos programados

PS C:\> Get-ScheduledJob | Enable-ScheduledJob -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        True
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     True
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       True

Este comando habilita todos los trabajos programados en el equipo local. Usa el cmdlet Get-ScheduledJob para obtener todo el trabajo programado y el cmdlet Enable-ScheduledJob 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

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} | ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

Este comando habilita los trabajos programados que no requieren una conexión de red.

El comando usa el cmdlet Get-ScheduledJob para obtener todos los trabajos programados en el equipo. Un operador de canalización envía los trabajos programados al cmdlet Get-ScheduledJobOption, 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 cmdlet Where-Object, que selecciona objetos de opción de trabajo programados en los que la propiedad runWithoutNetwork tiene un valor true ($true). Otro operador de canalización envía los objetos de opciones de trabajo programados seleccionados al cmdlet ForEach-Object que ejecuta una comando Enable-ScheduledJob 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

PS C:\> Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

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

El comando usa el cmdlet Invoke-Command para ejecutar un comando Enable-ScheduledJob 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 pide 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 (ID) 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 comando Get-ScheduledJob. También puede canalizar un objeto de 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 admiten 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 ninguna salida.

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

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. 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 para Enable-ScheduledJob.

Salidas

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Si usa el parámetro Passthru, Enable-ScheduledJob devuelve el trabajo programado que se ha habilitado. De lo contrario, este cmdlet no genera ninguna salida.

Notas

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