Condividi tramite

Remove-JobTrigger

  • Riferimento
Modulo:
PSScheduledJob

Eliminare i trigger di processo dai processi pianificati.

Sintassi

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

Descrizione

Il cmdlet Remove-JobTrigger elimina i trigger di processo dai processi pianificati.

Un trigger di processo definisce una pianificazione o condizioni ricorrenti per l'avvio di un processo pianificato. Per gestire i trigger di processo, usare i cmdlet New-JobTrigger, Add-JobTrigger, Set-JobTrigger e Set-ScheduledJob.

Usare i parametri Name, ID o InputObject di Remove-JobTrigger per identificare i processi pianificati da cui vengono rimossi i trigger. Usare il parametro TriggerID per identificare i trigger di processo da eliminare. Per impostazione predefinita, Remove-JobTrigger elimina tutti i trigger di processo di un processo pianificato.

Remove-JobTrigger è una raccolta 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 tutti i trigger di processo

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

Questo comando elimina tutti i trigger di processo da un processo pianificato con nomi che iniziano con Test.

Esempio 2: Eliminare i trigger di processo selezionati

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

Questo comando elimina solo il terzo trigger (ID = 3) dal processo pianificato BackupArchive.

Esempio 3: Eliminare i trigger del processo AtStartup da tutti i processi pianificati

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

Questa funzione elimina tutti i trigger del processo AtStartup da tutti i processi nel computer locale. Per usare la funzione , eseguire la funzione nella sessione e quindi digitare Delete-AtStartup.

La funzione Delete-AtStartup contiene un comando singolo. Il comando usa il cmdlet Get-ScheduledJob per ottenere i processi pianificati nel computer locale. Un operatore pipeline (|) invia i processi pianificati al cmdlet Get-JobTrigger, che ottiene tutti i trigger di processo da ognuno dei processi pianificati. Un operatore pipeline invia i trigger del processo al cmdlet Where-Object, che seleziona i trigger del processo in cui il valore della proprietà Frequency del trigger di processo è uguale a AtStartup.

Gli oggetti JobTrigger hanno una proprietà JobDefinition che contiene il processo pianificato attivato. Il resto del comando usa questa funzionalità.

Un operatore pipeline invia i trigger del processo AtStartup al cmdlet ForEach-Object, che esegue un comando Remove-JobTrigger in ogni trigger AtStartup. Il valore del parametro InputObject di Remove-JobTrigger è il processo pianificato nella proprietà JobDefinition del trigger di processo. Il valore del parametro TriggerID è l'identificatore nella proprietà ID del trigger di processo.

Esempio 4: Eliminare un trigger di processo da un processo pianificato remoto

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

Questo comando elimina il primo trigger di processo dal processo di inventario nel computer Server01.

Il comando usa il cmdlet Invoke-Command per eseguire il cmdlet Remove-JobTrigger nel computer Server01. Il cmdlet Remove-JobTrigger usa il parametro ID per identificare il processo pianificato inventory e il parametro TriggerID per specificare il primo trigger. Il parametro ID è particolarmente utile quando più processi pianificati hanno gli stessi nomi o nomi simili.

Parametri

-Id

Specifica i numeri di identificazione dei processi pianificati. Remove-JobTrigger elimina i trigger di processo dai processi pianificati specificati.

Per ottenere il numero di identificazione dei processi pianificati nel computer locale o in un computer remoto, usare il cmdlet Get-ScheduledJob.

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

-InputObject

Specifica i processi pianificati. 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 inviare tramite pipe oggetti ScheduledJob a Remove-JobTrigger.

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

-Name

Specifica i nomi dei processi pianificati. Remove-JobTrigger elimina i trigger di processo dai processi pianificati specificati. Sono supportati caratteri jolly.

Per ottenere i nomi dei processi pianificati nel computer locale o in un computer remoto, usare il cmdlet Get-ScheduledJob.

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

-TriggerId

Elimina solo il trigger di processo specificato. Per impostazione predefinita, Remove-JobTrigger elimina tutti i trigger dai processi pianificati. Usare questo parametro quando i processi pianificati hanno più trigger di processo.

Immettere gli ID trigger di uno o più trigger di un processo pianificato. Se si specificano più processi pianificati, Remove-JobTrigger elimina il trigger di processo con l'ID specificato da tutti i processi pianificati.

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

Input

ScheduledJobDefinition

È possibile inviare tramite pipe i processi pianificati al cmdlet Remove-JobTrigger.

Output

None

Il cmdlet non genera alcun output.