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

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

Un operatore della pipeline invia i trigger del processo AtStartup al ForEach-Object cmdlet , che esegue un Remove-JobTrigger comando 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 del 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 di processo dal processo di inventario nel computer Server01.

Il comando usa il Invoke-Command cmdlet per eseguire il Remove-JobTrigger cmdlet nel computer Server01. Il Remove-JobTrigger cmdlet 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 Get-ScheduledJob cmdlet .

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 Get-ScheduledJob comando. È 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 Get-ScheduledJob cmdlet .

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

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 output.