Dela via

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 ett schemalagt jobb tas bort eller avregistreras tas katalogen för det schemalagda jobbet bort (i katalogen $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs), 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.

Avregistrera schemalagtjobb tar endast 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 för Avregistrera schemalagtjobb för att ta bort schemalagda jobb efter ID eller namn, eller skicka schemalagda jobb från Get-ScheduledJob till Avregistrera schemalagtjobb.

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 Om ämnen 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 ett schemalagt jobb

PS C:\> Unregister-ScheduledJob TestJob

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

Exempel 2: Ta bort alla schemalagda jobb

PS C:\> Get-ScheduledJob | Unregister-ScheduledJob -Force
PS C:\> 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 Avregistrera schemajobb, vilket tar bort dem.

Det andra kommandot använder name-parametern 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

PS C:\> 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-Command för att köra kommandot Unregister-ScheduledJob 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. Avregistrera schemalagt jobb avbryter som standard inte jobb som körs.

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

-Id

Tar bort de schemalagda jobben med angivna ID-nummer (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 schemalagda jobb till Unregister-ScheduledJob

Utdata

None

Denna cmdlet genererar inga utdata.