Compartir a través de

Disable-JobTrigger

  • Referencia
Módulo:
PSScheduledJob

Deshabilita los desencadenadores de trabajo de los trabajos programados.

Syntax

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

Description

El Disable-JobTrigger cmdlet deshabilita temporalmente los desencadenadores de trabajo de los trabajos programados. Al deshabilitarlos, se conservan todas las propiedades del desencadenador de trabajo, pero se impide que este inicie el trabajo programado.

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

Para deshabilitar un desencadenador de trabajo, el Disable-JobTrigger cmdlet establece la propiedad Enabled del desencadenador $Falsede trabajo en . Para volver a habilitar el desencadenador de trabajo, use el Enable-JobTrigger cmdlet , que establece la propiedad Enabled del desencadenador de trabajo en $True. Deshabilitar un desencadenador de trabajo no deshabilita el trabajo programado, como lo hace el Disable-ScheduledJob cmdlet , pero si deshabilita todos los desencadenadores de trabajo, el efecto es el mismo que deshabilitar el trabajo programado.

Si deshabilita un trabajo programado o deshabilita todos los desencadenadores de trabajo de un trabajo programado, puede iniciar el trabajo mediante el Start-Job cmdlet o usar el trabajo programado deshabilitado como plantilla.

Disable-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: Deshabilitar un desencadenador de trabajo

En este ejemplo se deshabilita el primer desencadenador de un trabajo programado en el equipo local.

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

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 Disable-JobTrigger cmdlet , que lo deshabilita.

Ejemplo 2: Deshabilitar todos los desencadenadores de trabajo

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize

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

El primer comando usa el Get-ScheduledJob cmdlet para obtener los Backup-Archives trabajos programados de inventario y . 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 Disable-JobTrigger cmdlet , que los deshabilita. El primer comando usa el Get-ScheduledJob cmdlet para obtener los trabajos, ya que su parámetro Name toma varios nombres.

El segundo comando muestra los resultados. El comando repite el Get-ScheduledJob comando y Get-JobTrigger . Un operador de canalización envía los desencadenadores de trabajo al Format-Table cmdlet , que muestra los desencadenadores de trabajo en una tabla. El Format-Table comando agrega una propiedad JobName que muestra el valor de la propiedad Name del trabajo programado en la propiedad JobDefinition del objeto desencadenador de trabajo.

Estos comandos deshabilitan todos los desencadenadores de trabajo de dos trabajos programados y muestran los resultados.

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

En este ejemplo se deshabilitan los desencadenadores de trabajo diarios para un trabajo programado en un equipo remoto.

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

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 diarios. Un operador de canalización envía los desencadenadores de trabajo diarios al Disable-JobTrigger cmdlet , que los deshabilita.

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 deshabilitar. 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 Disable-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:None
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 un desencadenador de trabajo a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

  • Disable-JobTrigger no genera errores ni advertencias si deshabilita un desencadenador de trabajo que ya está deshabilitado.