Compartir a través de


Enable-JobTrigger

Habilita los desencadenadores de trabajos programados.

Sintaxis

Default (valor predeterminado)

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

Description

El cmdlet Enable-JobTrigger vuelve a habilitar desencadenadores de trabajos programados, como los que se deshabilitaron mediante el cmdlet Disable-JobTrigger. Los desencadenadores de trabajos habilitados y habilitados pueden iniciar trabajos programados inmediatamente; 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 para 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 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 desencadenador de trabajo

PS C:\> Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

Este comando habilita el primer desencadenador (ID=1) del Backup-Archives trabajo programado 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: Habilitación de 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 , lo 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 de 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 de AtLogon al cmdlet Enable-JobTrigger , que los habilita.

Ejemplo 4: Mostrar desencadenadores de trabajos 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 trabajos deshabilitados de todos los trabajos programados de una tabla. Puede usar un comando como este para detectar desencadenadores de trabajo que podrían necesitar habilitarse.

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 de Where-Object, que devuelve solo los desencadenadores de trabajo que están deshabilitados, es decir, en los que 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 pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 de ScheduledJobTrigger a Enable-JobTrigger.

Propiedades de parámetro

Tipo:

ScheduledJobTrigger[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.