Disable-JobTrigger
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
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.
Vínculos relacionados
- about_Scheduled_Jobs
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob