Remove-JobTrigger

  • Referens
Modul:
PSScheduledJob

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 Namn, ID eller InputObject för för att identifiera de schemalagda jobb som utlösarna tas bort från. Remove-JobTrigger 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 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.

Exempel

Exempel 1: Ta bort alla jobbutlösare

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.

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-JobTrigger InputObject 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-JobTriggeranvä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 ID-nummer för de schemalagda jobben. Remove-JobTrigger tar bort jobbutlösare från de angivna schemalagda jobben.

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

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

-InputObject

Anger de schemalagda jobben. 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:ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
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
Required:True
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 de schemalagda jobben 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 du bort jobbutlösaren med det angivna ID:t från alla schemalagda jobb.

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

Indata

ScheduledJobDefinition

Du kan skicka ett schemalagt jobb till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.