Compartir a través de

Unregister-ScheduledJob

  • Referencia
Módulo:
PSScheduledJob

Elimina trabajos programados en el equipo local.

Syntax

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

El Unregister-ScheduledJob cmdlet elimina los trabajos programados del equipo local.

Cuando elimina o anula el registro de un trabajo programado, Unregister-ScheduledJob elimina el directorio del trabajo programado (en el $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory), que contiene el archivo XML que define el trabajo programado, el historial de ejecución del trabajo y todos los resultados del trabajo. Con esta acción también se elimina el trabajo del Programador de tareas.

Unregister-ScheduledJob elimina solo los trabajos programados que se crean mediante el Register-ScheduledJob cmdlet . No elimina los trabajos programados que se crean en el Programador de tareas.

Puede usar los parámetros de Unregister-ScheduledJob para eliminar trabajos programados por identificador o nombre, o canalizar trabajos programados de Get-ScheduledJob a Unregister-ScheduledJob.

Unregister-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: Eliminación de un trabajo programado

Unregister-ScheduledJob TestJob

Este comando elimina el trabajo programado TestJob del equipo local.

Ejemplo 2: Eliminación de todos los trabajos programados

Get-ScheduledJob | Unregister-ScheduledJob -Force
Unregister-ScheduledJob -Name "*" -Force

En este ejemplo se muestran dos comandos diferentes que eliminan todos los trabajos programados en el equipo local.

El primer comando usa el Get-ScheduledJob cmdlet para obtener todos los trabajos programados en el equipo local. Un operador de canalización (|) envía los trabajos programados a Unregister-ScheduleJob, que los elimina.

El segundo comando usa el parámetro Name de Unregister-ScheduledJob con un valor de todo (*) para eliminar todos los trabajos programados.

Ambos comandos usan el parámetro Force , que elimina un trabajo programado incluso si se está ejecutando una instancia del trabajo.

Ejemplo 3: Eliminación de un trabajo programado en un equipo remoto

Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

Este comando elimina los trabajos programados con nombres que comienzan por Test en el equipo remoto Server01. El comando usa el Invoke-Command cmdlet para ejecutar el Unregister-ScheduledJob comando en el equipo Server02.

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

-Force

Elimina el trabajo programado, aun cuando se esté ejecutando una instancia de ese trabajo. De forma predeterminada, Unregister-ScheduledJob no interrumpe los trabajos en ejecución.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Elimina los trabajos programados con los números de identificación especificados. Escriba los identificadores de los trabajos programados en el equipo.

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

-InputObject

Especifica un trabajo programado 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 Unregister-JobTrigger.

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

-Name

Elimina los trabajos programados con los nombres especificados. Escriba los nombres de uno o varios trabajos programados en el equipo. Se admite caracteres comodín.

Type:String[]
Position:0
Default value:None
Required:True
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

ScheduledJobDefinition

Puede canalizar un trabajo programado a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.