Disable-JobTrigger

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

El cmdlet Disable-JobTrigger deshabilita temporalmente los desencadenadores de trabajo de los trabajos programados. Deshabilitar conserva todas las propiedades del desencadenador de trabajos, pero impide que el desencadenador de trabajo inicie el trabajo programado.

Para usar este cmdlet, use el cmdlet Get-JobTrigger para obtener los desencadenadores de trabajo. A continuación, canalice los desencadenadores de trabajo para 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, puede iniciar el trabajo mediante el cmdlet Start-Job o usar el trabajo programado deshabilitado como plantilla.

Disable-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.

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

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

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 en dos trabajos programados y muestran los resultados.

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

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.

Puede canalizar desencadenadores de trabajo a Disable-JobTrigger.

Este cmdlet no genera ningún resultado.

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