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[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Name] <String[]>
      [<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 il Name, IDo i parametri 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 processi pianificati, vedere gli argomenti About 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

Remove-JobTrigger -Name "Test*"

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

Esempio 2: Eliminare i trigger di processo selezionati

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

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 di 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 singolo comando. 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 di processo al cmdlet Where-Object, che seleziona i trigger di processo in cui il valore della proprietà Frequency del trigger di processo è uguale a AtStartup.

oggetti JobTrigger dispongono di una proprietà JobDefinition che contiene il processo pianificato attivato. Il resto del comando usa tale funzionalità preziosa.

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

Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Questo comando elimina il primo trigger del 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.

Tipo:Int32[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:ScheduledJobDefinition[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TriggerId

Elimina solo i trigger di processo specificati. 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 processo 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.

Tipo:Int32[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

ScheduledJobDefinition

È possibile inviare tramite pipe un processo pianificato a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.