Condividi tramite

Unregister-ScheduledJob

  • Riferimento
Modulo:
PSScheduledJob

Elimina i processi pianificati nel computer locale.

Sintassi

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

Descrizione

Il cmdlet Unregister-ScheduledJob elimina processi pianificati dal computer locale.

Quando elimina o annulla la registrazione di un processo pianificato, Annulla registrazione-ScheduledJob elimina la directory per il processo pianificato (nella directory $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs), che contiene il file XML che definisce il processo pianificato, la cronologia dell'esecuzione del processo e tutti i risultati del processo. Questa azione elimina anche il processo dall'Utilità di pianificazione.

Annulla la registrazione-ScheduledJob elimina solo i processi pianificati creati usando il cmdlet Register-ScheduledJob. Non elimina i processi pianificati creati nell'Utilità di pianificazione.

È possibile usare i parametri di Unregister-ScheduledJob per eliminare i processi pianificati in base all'ID o al nome o ai processi pianificati della pipe da Get-ScheduledJob a Annulla registrazione-ScheduledJob.

Unregister-ScheduledJob è una delle raccolte di cmdlet di pianificazione dei processi nel modulo PSScheduledJob incluso in Windows PowerShell.

Per altre informazioni sui lavori pianificati, vedere gli argomenti Informazioni nel modulo PSScheduledJob. Importare il modulo PSScheduledJob e quindi digitare: Get-Help about_Scheduled* o vedere about_Scheduled_Jobs.

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Eliminare un processo pianificato

PS C:\> Unregister-ScheduledJob TestJob

Questo comando elimina il processo pianificato TestJob nel computer locale.

Esempio 2: Eliminare tutti i processi pianificati

PS C:\> Get-ScheduledJob | Unregister-ScheduledJob -Force
PS C:\> Unregister-ScheduledJob -Name "*" -Force

Questo esempio mostra due comandi diversi che eliminano tutti i processi pianificati nel computer locale.

Il primo comando usa il cmdlet Get-ScheduledJob per ottenere tutti i processi pianificati nel computer locale. Un operatore pipeline (|) invia i processi pianificati a Unregister-ScheduleJob, che li elimina.

Il secondo comando usa il parametro Name di Unregister-ScheduledJob con un valore all (*) per eliminare tutti i processi pianificati.

Entrambi i comandi usano il parametro Force, che elimina un processo pianificato anche se è in esecuzione un'istanza del processo.

Esempio 3: Eliminare un processo pianificato in un computer remoto

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

Questo comando elimina i processi pianificati con nomi che iniziano con Test nel computer remoto server01. Il comando usa il cmdlet Invoke-Command per eseguire il comando Unregister-ScheduledJob nel computer Server02.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Force

Elimina il processo pianificato, anche se è in esecuzione un'istanza del processo. Per impostazione predefinita, Unregister-ScheduledJob non interrompe processi in esecuzione.

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

-Id

Disabilita i processi pianificati con i numeri di identificazione (ID) specificati. Immettere gli ID dei processi pianificati nel computer.

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

-InputObject

Specifica un processo pianificato. Immettere una variabile contenente oggetti ScheduledJob o digitare un comando o un'espressione che ottiene oggetti ScheduledJob , ad esempio un comando Get-ScheduledJob. È anche possibile eseguire la pipe degli oggetti ScheduledJob in Unregister-JobTrigger.

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

-Name

Elimina i processi pianificati con i nomi specificati. Immettere i nomi di uno o più processi pianificati nel computer. Sono supportati caratteri jolly.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

ScheduledJobDefinition

È possibile inviare tramite pipe i processi pianificati a Unregister-ScheduledJob

Output

None

Questo cmdlet non genera alcun output.