Compartir a través de

Enable-JobTrigger

  • Referencia
Módulo:
PSScheduledJob

Habilita los desencadenadores de trabajo de los trabajos programados.

Sintaxis

Enable-JobTrigger
      [-InputObject] <ScheduledJobTrigger[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Enable-JobTrigger cmdlet vuelve a habilitar los desencadenadores de trabajos programados, como los que se deshabilitaron mediante el Disable-JobTrigger cmdlet . Los desencadenadores de trabajo que están habilitados o que se han vuelto a habilitar pueden iniciar trabajos programados inmediatamente; es decir, no es necesario reiniciar Windows o Windows PowerShell.

Para usar este cmdlet, use el Get-JobTrigger cmdlet para obtener los desencadenadores de trabajo. A continuación, canalice los desencadenadores de trabajo a Enable-JobTrigger o use su parámetro InputObject .

Para habilitar un desencadenador de trabajo, el Enable-JobTrigger cmdlet establece la propiedad Enabled del desencadenador de trabajo en $true.

Enable-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 desencadenador de trabajo

Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

Este comando habilita el primer desencadenador (con el identificador 1) del trabajo programado Backup-Archives en el equipo local.

El comando usa el Get-JobTrigger cmdlet para obtener el desencadenador de trabajo. Un operador de canalización envía el desencadenador de trabajo al Enable-JobTrigger cmdlet , que lo habilita.

Ejemplo 2: Habilitación de todos los desencadenadores de trabajo

Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

El comando usa el Get-ScheduledJob cmdlet para obtener los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados al Get-JobTrigger cmdlet , que obtiene todos los desencadenadores de trabajo de los trabajos programados. Otro operador de canalización envía los desencadenadores de trabajo al Enable-JobTrigger cmdlet , lo que les permite.

Ejemplo 3: Habilitar el desencadenador de trabajo de un trabajo programado en un equipo remoto

Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "AtLogon"} | Enable-JobTrigger}

Este comando vuelve a habilitar los desencadenadores de trabajo AtLogon en el trabajo programado DeployPackage en el equipo remoto Server01.

El comando usa el Invoke-Command cmdlet para ejecutar los comandos en el equipo Server01. El comando remoto usa el Get-JobTrigger cmdlet para obtener los desencadenadores de trabajo del trabajo programado DeployPackage. Un operador de canalización envía los desencadenadores de trabajo al Where-Object cmdlet que devuelve solo desencadenadores de trabajo atLogon. Un operador de canalización envía los desencadenadores de trabajo de AtLogon al Enable-JobTrigger cmdlet , lo que les permite.

Ejemplo 4: Mostrar desencadenadores de trabajos deshabilitados

Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
 1    Weekly 9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
 2    Daily  9/29/2011 1:00:00 AM              False   Backup-Archive
 1    Weekly 10/20/2011 11:00:00 PM {Friday}   False   Inventory
 1    Weekly 11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Este comando muestra todos los desencadenadores de trabajo deshabilitados de todos los trabajos programados de una tabla. Un comando como este puede servir para detectar los desencadenadores de trabajo que posiblemente deban estar habilitados.

El comando usa el Get-ScheduledJob cmdlet para obtener los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados al Get-JobTrigger cmdlet , que obtiene todos los desencadenadores de trabajo de los trabajos programados. Otro operador de canalización envía los desencadenadores de trabajo al Where-Object cmdlet , que devuelve solo los desencadenadores de trabajo que están deshabilitados, es decir, donde el valor de la propiedad Enabled del desencadenador de trabajo no es (!) true.

Otro operador de canalización envía los desencadenadores de trabajo deshabilitados al Format-Table cmdlet , que muestra las propiedades seleccionadas de los desencadenadores de trabajo en una tabla. Las propiedades incluyen una nueva propiedad JobName que muestra el nombre del trabajo programado en la propiedad JobDefinition del desencadenador de trabajo.

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

-InputObject

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

Tipo:ScheduledJobTrigger[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

ScheduledJobTrigger

Puede canalizar un desencadenador de trabajo a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

  • Enable-JobTrigger no genera errores ni advertencias si habilita un desencadenador de trabajo que ya está habilitado.