Unregister-ScheduledJob

  • Referens
Modul:
PSScheduledJob

Tar bort schemalagda jobb på den lokala datorn.

Syntax

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

Cmdleten Unregister-ScheduledJob tar bort schemalagda jobb från den lokala datorn.

När det tar bort eller avregistrerar ett schemalagt jobb Unregister-ScheduledJob tar du bort katalogen för det schemalagda jobbet (i $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory), som innehåller XML-filen som definierar det schemalagda jobbet, jobbkörningshistoriken och alla jobbresultat. Den här åtgärden tar också bort jobbet från Schemaläggaren.

Unregister-ScheduledJob tar bara bort de schemalagda jobb som skapas med hjälp av cmdleten Register-ScheduledJob . Det tar inte bort schemalagda jobb som skapas i Schemaläggaren.

Du kan använda parametrarna Unregister-ScheduledJob för för att ta bort schemalagda jobb med ID eller namn, eller skicka schemalagda jobb från Get-ScheduledJob till Unregister-ScheduledJob.

Unregister-ScheduledJob ä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 ett schemalagt jobb

Unregister-ScheduledJob TestJob

Det här kommandot tar bort det schemalagda testjobbet på den lokala datorn.

Exempel 2: Ta bort alla schemalagda jobb

Get-ScheduledJob | Unregister-ScheduledJob -Force
Unregister-ScheduledJob -Name "*" -Force

Det här exemplet visar två olika kommandon som tar bort alla schemalagda jobb på den lokala datorn.

Det första kommandot använder cmdleten Get-ScheduledJob för att hämta alla schemalagda jobb på den lokala datorn. En pipelineoperator (|) skickar de schemalagda jobben till Unregister-ScheduleJob, som tar bort dem.

Det andra kommandot använder parametern Namn för Unregister-ScheduledJob med värdet alla (*) för att ta bort alla schemalagda jobb.

Båda kommandona använder parametern Force , som tar bort ett schemalagt jobb även om en instans av jobbet körs.

Exempel 3: Ta bort ett schemalagt jobb på en fjärrdator

Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

Det här kommandot tar bort schemalagda jobb med namn som börjar med Test på server01-fjärrdatorn. Kommandot använder cmdleten Invoke-CommandUnregister-ScheduledJob för att köra kommandot på Server02-datorn.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Tar bort det schemalagda jobbet även om en instans av jobbet körs. Som standard Unregister-ScheduledJob avbryter inte jobb som körs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Tar bort de schemalagda jobben med angivna ID(ID). Ange ID:t för schemalagda jobb på datorn.

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

-InputObject

Anger ett schemalagt 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 Unregister-JobTrigger.

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

-Name

Tar bort de schemalagda jobben med de angivna namnen. Ange namnen på ett eller flera schemalagda jobb på datorn. Jokertecken stöds.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
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.