Remove-JobTrigger

Ta bort jobbutlösare från schemalagda jobb.

Syntax

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

Description

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 Remove-JobTriggerNamn, ID eller InputObject för 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 Remove-JobTrigger tar 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 Om ämnen i modulen PSScheduledJob. Importera modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Denna cmdlet introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Ta bort alla jobbutlösare

Remove-JobTrigger -Name "Test*"

Det här kommandot tar bort alla jobbutlösare från det schemalagda jobbet med namn som börjar med Test.

Exempel 2: Ta bort valda jobbutlösare

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.

Exempel 3: Ta bort AtStartup-jobbutlösare från alla schemalagda jobb

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 Delete-AtStartupsedan .

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ösare 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 en JobDefinition-egenskap som innehåller det schemalagda jobb som de utlöser. Resten av kommandot använder den värdefulla funktionen.

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

Exempel 4: Ta bort en jobbutlösare från ett fjärrplanerat jobb

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. ID-parametern är särskilt användbar när flera schemalagda jobb har samma eller liknande namn.

Parametrar

-Id

Anger identifieringsnumren för de schemalagda jobben. Remove-JobTrigger tar bort jobbutlösare från de angivna schemalagda jobben.

Använd cmdleten för att hämta identifieringsnumret för schemalagda jobb på den lokala datorn eller en fjärrdator Get-ScheduledJob .

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

-InputObject

Anger schemalagda jobb. Ange en variabel som innehåller ScheduledJob-objekt eller skriv ett kommando eller uttryck som hämtar ScheduledJob-objekt , till exempel ett Get-ScheduledJob kommando. Du kan också skicka ScheduledJob-objekt till Remove-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnen på de schemalagda jobben. Remove-JobTrigger tar bort jobbutlösarna från de angivna schemalagda jobben. Jokertecken stöds.

Om du vill hämta namnen på schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob .

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

-TriggerId

Tar bara bort de angivna jobbutlösarna. Som standard Remove-JobTrigger tar bort alla utlösare från de schemalagda jobben. Använd den här parametern när schemalagda jobb har flera jobbutlösare.

Ange utlösar-ID:t för en eller flera jobbutlösare för ett schemalagt jobb. Om du anger flera schemalagda jobb Remove-JobTrigger tar bort jobbutlösaren med det angivna ID:t från alla schemalagda jobb.

Type:Int32[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Indata

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Du kan skicka schemalagda jobb till cmdleten Remove-JobTrigger .

Utdata

None

Cmdleten genererar inga utdata.