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 cmdlet Disable-JobTrigger 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 cmdlet Get-JobTrigger para obtener los desencadenadores de trabajo. Luego, canalice los desencadenadores de trabajo a Disable-JobTrigger o use su parámetro InputObject.

Para deshabilitar un desencadenador de trabajo, el cmdlet Disable-JobTrigger establece la propiedad Enabled del desencadenador de trabajo en $False. Para volver a habilitar el desencadenador de trabajo, use el cmdlet Enable-JobTrigger, 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 cmdlet Disable-ScheduledJob, 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, todavía puede iniciar el trabajo mediante el cmdlet Start-Job 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

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

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

Ejemplo 2: Deshabilitar todos los desencadenadores de trabajo

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> 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

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

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

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

Se pueden canalizar desencadenadores de trabajo a Disable-JobTrigger.

Salidas

None

Este cmdlet no genera ningún resultado.

Notas

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