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 cmdlet Unregister-ScheduledJob elimina 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 directorio $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs), 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 cmdlet Register-ScheduledJob. 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

PS C:\> Unregister-ScheduledJob TestJob

Este comando elimina el trabajo programado TestJob del equipo local.

Ejemplo 2: Eliminación de todos los trabajos programados

PS C:\> Get-ScheduledJob | Unregister-ScheduledJob -Force
PS C:\> 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 cmdlet Get-ScheduledJob 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 todos (*) para eliminar todos los trabajos programados.

Ambos comandos usan el parámetro Force, que elimina un trabajo programado aun cuando se esté ejecutando una instancia de ese trabajo.

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

PS C:\> Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

Este comando elimina trabajos programados con nombres que comienzan por Test en el equipo remoto Server01. El comando usa el cmdlet Invoke-Command para ejecutar el comando Unregister-ScheduledJob 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. Unregister-ScheduledJob no interrumpe la ejecución de trabajos de forma predeterminada.

Type:	SwitchParameter
Position:	Named
Default value:	False
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 obtiene objetos ScheduledJob , como un comando Get-ScheduledJob. También se pueden 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

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Se pueden canalizar trabajos programados a Unregister-ScheduledJob.

Salidas

None

Este cmdlet no genera ningún resultado.