Compartir a través de

Remove-JobTrigger

  • Referencia
Módulo:
PSScheduledJob

Eliminar desencadenadores de trabajos de trabajos programados.

Sintaxis

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

Description

El Remove-JobTrigger cmdlet 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 .

Use 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

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

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

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 Delete-AtStartup función contiene un único comando. El comando usa el Get-ScheduledJob cmdlet para obtener los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados al Get-JobTrigger cmdlet , 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 Where-Object cmdlet , 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 ForEach-Object cmdlet , que ejecuta un Remove-JobTrigger comando en cada desencadenador atStartup. El valor del parámetro InputObject de Remove-JobTrigger es el trabajo programado en 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 de un trabajo programado remoto

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 Invoke-Command cmdlet para ejecutar el Remove-JobTrigger cmdlet en el equipo Server01. El Remove-JobTrigger cmdlet 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 desencadenadores de trabajo de los trabajos programados especificados.

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

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 Get-ScheduledJob comando. También puede canalizar objetos ScheduledJob a Remove-JobTrigger.

Tipo:ScheduledJobDefinition[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

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

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

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Int32[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

ScheduledJobDefinition

Puede canalizar un trabajo programado a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.