Unregister-ScheduledJob

Unregister-ScheduledJob
    [-InputObject] <ScheduledJobDefinition[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Unregister-ScheduledJob
    [-Id] <Int32[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Unregister-ScheduledJob
    [-Name] <String[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

När ett schemalagt jobb tas bort eller avregistreras Avregistrera schemalagt jobb tar bort katalogen för det schemalagda jobbet (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 Unregister-ScheduledJob för att ta bort schemalagda jobb med 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 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.

PS C:\> Unregister-ScheduledJob TestJob

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

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-ScheduleJob, som tar bort dem.

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

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.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka schemalagda jobb till Unregister-ScheduledJob

Den här cmdleten genererar inga utdata.