Remove-JobTrigger

  • Referencia
Módulo:
PSScheduledJob

Eliminar desencadenadores de trabajo de trabajos programados.

Syntax

Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-InputObject] <ScheduledJobDefinition[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Name] <String[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]

Description

El cmdlet Remove-JobTrigger elimina los desencadenadores de trabajo de los trabajos programados.

Un desencadenador de trabajo define una programación o condiciones periódicas para iniciar un trabajo programado. Para administrar desencadenadores de trabajo, use los cmdlets New-JobTrigger, Add-JobTrigger, Set-JobTrigger y Set-ScheduledJob.

Utilice los parámetros Name, ID o InputObject de Remove-JobTrigger para identificar los trabajos programados de los que se quitan los desencadenadores. Use el parámetro TriggerID para identificar los desencadenadores de trabajo que se van a eliminar. De forma predeterminada, Remove-JobTrigger elimina todos los desencadenadores de trabajo de un trabajo programado.

Remove-JobTrigger 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: Eliminación de todos los desencadenadores de trabajo

PS C:\> Remove-JobTrigger -Name "Test*"

Este comando elimina todos los desencadenadores de trabajo del trabajo programado que tienen nombres que comienzan por Test.

Ejemplo 2: Eliminación de desencadenadores de trabajo seleccionados

PS C:\> Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Este comando elimina solo el tercer desencadenador (ID = 3) del trabajo programado BackupArchive.

Ejemplo 3: Eliminación de desencadenadores de trabajo atStartup de todos los trabajos programados

PS C:\> function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

Esta función elimina todos los desencadenadores de trabajo AtStartup de todos los trabajos del equipo local. Para usar la función , ejecute la función en la sesión y escriba Delete-AtStartup.

La función Delete-AtStartup contiene un solo comando. 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 cada uno de los trabajos programados. Un operador de canalización envía los desencadenadores de trabajo al cmdlet Where-Object, que selecciona desencadenadores de trabajo donde el valor de la propiedad Frequency del desencadenador de trabajo es igual a AtStartup.

Los objetos JobTrigger tienen una propiedad JobDefinition que contiene el trabajo programado que desencadenan. El resto del comando utiliza esa característica de valor.

Un operador de canalización envía los desencadenadores de trabajo AtStartup al cmdlet ForEach-Object, que ejecuta un comando Remove-JobTrigger en cada desencadenador atStartup. El valor del parámetro InputObject de Remove-JobTrigger es el trabajo programado de la propiedad JobDefinition del desencadenador de trabajo. El valor del parámetro TriggerID es el identificador de la propiedad ID del desencadenador de trabajo.

Ejemplo 4: Eliminación de un desencadenador de trabajo desde un trabajo programado remoto

PS C:\> Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Este comando elimina el primer desencadenador de trabajo del trabajo de inventario en el equipo Server01.

El comando usa el cmdlet Invoke-Command para ejecutar el cmdlet Remove-JobTrigger en el equipo Server01. El cmdlet Remove-JobTrigger usa el parámetro ID para identificar el trabajo programado Inventory y el parámetro TriggerID para especificar el primer desencadenador. El parámetro ID es especialmente útil cuando varios trabajos programados tienen los mismos nombres o similares.

Parámetros

-Id

Especifica los números de identificación de los trabajos programados. Remove-JobTrigger elimina los desencadenadores de trabajo de los trabajos programados que se especifiquen.

Para obtener el número de identificación de trabajos programados en el equipo local o en un equipo remoto, use el cmdlet Get-ScheduledJob.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica los trabajos programados. Escriba una variable que contenga objetos ScheduledJob o escriba un comando o expresión que obtenga objetos ScheduledJob , como un comando Get-ScheduledJob. También puede canalizar objetos ScheduledJob a Remove-JobTrigger.

Type:ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica los nombres de los trabajos programados. Remove-JobTrigger elimina los desencadenadores de trabajo de los trabajos programados que se especifiquen. Se admite caracteres comodín.

Para obtener los nombres de los trabajos programados en el equipo local o en un equipo remoto, use el cmdlet Get-ScheduledJob.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TriggerId

Elimina solo los desencadenadores de trabajo especificados. De forma predeterminada, Remove-JobTrigger elimina todos los desencadenadores de los trabajos programados. Utilice este parámetro si los trabajos programados tienen varios desencadenadores de trabajo.

Escriba los identificadores de uno o más desencadenadores de trabajo de un trabajo programado. Si especifica varios trabajos programados, Remove-JobTrigger elimina el desencadenador de trabajo con el identificador especificado de todos los trabajos programados.

Type:Int32[]
Position:Named
Default value:All triggers
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Puede canalizar los trabajos programados al cmdlet Remove-JobTrigger.

Salidas

None

Este cmdlet no genera ningún resultado.