Dela via

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[]>]
      [-Name] <String[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<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 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 PSScheduledJob-modulen 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

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

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

Exempel 2: Ta bort markerade jobbutlösare

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.

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

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 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 kommandot Remove-JobTrigger på varje AtStartup-utlösare. Värdet för parametern InputObject för Remove-JobTrigger ä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

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 jobbet Inventory 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.

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

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 tar Remove-JobTrigger 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 tar Remove-JobTrigger bort jobbutlösaren med det angivna ID:t från alla schemalagda jobb.

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

Indata

ScheduledJobDefinition

Du kan skicka schemalagda jobb till cmdleten Remove-JobTrigger .

Utdata

None

Cmdleten genererar inga utdata.