Remove-JobTrigger

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

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

Remove-JobTrigger
    [-Id] <Int32[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

Cmdleten Remove-JobTrigger tar bort jobbutlösare från schemalagda jobb.

En jobbutlösare definierar ett återkommande schema eller villkor för att starta ett schemalagt jobb. Om du vill hantera jobbutlösare använder du cmdletarna New-JobTrigger, Add-JobTrigger, Set-JobTrigger och Set-ScheduledJob.

Använd parametrarna Name, IDeller InputObject för Remove-JobTrigger för att identifiera de schemalagda jobb som utlösarna tas bort från. Använd parametern TriggerID för att identifiera jobbutlösare som ska tas bort. Som standard tar Remove-JobTrigger bort alla jobbutlösare för ett schemalagt jobb.

Remove-JobTrigger är en av en samling cmdletar för jobbschemaläggning i modulen PSScheduledJob som ingår i Windows PowerShell.

Mer information om schemalagda jobb finns i Avsnittet om i modulen PSScheduledJob. Importera modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Den här cmdleten introducerades i Windows PowerShell 3.0.

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

Det här kommandot tar bort alla jobbutlösare från ett schemalagt jobb med namn som börjar med Test.

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

Det här kommandot tar bara bort den tredje utlösaren (ID = 3) från det schemalagda jobbet BackupArchive.

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

Den här funktionen tar bort alla AtStartup-jobbutlösare från alla jobb på den lokala datorn. Om du vill använda funktionen kör du funktionen i sessionen och skriver sedan Delete-AtStartup.

Funktionen Delete-AtStartup innehåller ett enda kommando. Kommandot använder cmdleten Get-ScheduledJob för att hämta schemalagda jobb på den lokala datorn. En pipelineoperator (|) skickar de schemalagda jobben till cmdleten Get-JobTrigger, som hämtar alla jobbutlösare från vart och ett av de schemalagda jobben. En pipelineoperator skickar jobbutlösarna till cmdleten Where-Object, som väljer jobbutlösare där värdet för egenskapen Frequency för jobbutlösaren är lika med AtStartup.

JobTrigger objekt har egenskapen JobDefinition som innehåller det schemalagda jobb som de utlöser. Resten av kommandot använder den värdefulla funktionen.

En pipelineoperator skickar utlösare för AtStartup-jobbet till cmdleten ForEach-Object, som kör kommandot Remove-JobTrigger på varje AtStartup-utlösare. Värdet för parametern InputObject för Remove-JobTrigger är det schemalagda jobbet i egenskapen JobDefinition för jobbutlösaren. Värdet för parametern TriggerID är identifieraren i ID-egenskapen för jobbutlösaren.

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

Det här kommandot tar bort den första jobbutlösaren från inventeringsjobbet på Server01-datorn.

Kommandot använder cmdleten Invoke-Command för att köra cmdleten Remove-JobTrigger på Server01-datorn. Cmdleten Remove-JobTrigger använder ID-parametern för att identifiera det schemalagda inventeringsjobbet och parametern TriggerID för att ange den första utlösaren. Parametern ID är särskilt användbar när flera schemalagda jobb har samma eller liknande namn.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka schemalagda jobb till cmdleten Remove-JobTrigger.

Cmdleten genererar inga utdata.