Compartir a través de

Enable-JobTrigger

  • Referencia
Módulo:
PSScheduledJob

Habilita los desencadenadores de trabajo de los trabajos programados.

Syntax

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

Description

El cmdlet Enable-JobTrigger vuelve a habilitar los desencadenadores de trabajos programados, como los que se deshabilitaron mediante el cmdlet Disable-JobTrigger. 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 cmdlet Get-JobTrigger 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 cmdlet Enable-JobTrigger 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

PS C:\> 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 cmdlet Get-JobTrigger para obtener el desencadenador de trabajo. Un operador de canalización envía el desencadenador de trabajo al cmdlet Enable-JobTrigger, que lo habilita.

Ejemplo 2: Habilitar todos los desencadenadores de trabajo

PS C:\> Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

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

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

PS C:\> 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 cmdlet Invoke-Command para ejecutar los comandos en el equipo Server01. El comando remoto usa el cmdlet Get-JobTrigger para obtener los desencadenadores de trabajo del trabajo programado DeployPackage. Un operador de canalización envía los desencadenadores de trabajo al cmdlet Where-Object que devuelve solo desencadenadores de trabajo atLogon. Un operador de canalización envía los desencadenadores de trabajo atLogon al cmdlet Enable-JobTrigger , que los habilita.

Ejemplo 4: Mostrar desencadenadores de trabajo deshabilitados

PS C:\> 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 cmdlet Get-ScheduledJob para obtener los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados al cmdlet Get-JobTrigger, que obtiene todos los desencadenadores de trabajo de los trabajos programados. Otro operador de canalización envía los desencadenadores de trabajo al cmdlet Where-Object, 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 cmdlet Format-Table, 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 comando Get-JobTrigger. También puede canalizar un objeto ScheduledJobTrigger a Enable-JobTrigger.

Type:ScheduledJobTrigger[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

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

-WhatIf

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

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

Entradas

ScheduledJobTrigger

Puede canalizar desencadenadores de trabajo a Enable-JobTrigger.

Salidas

None

Este cmdlet no genera ningún resultado.

Notas

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