Unregister-ScheduledJob

  • Referencia
Modul:
PSScheduledJob

Törli az ütemezett feladatokat a helyi számítógépen.

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

A Unregister-ScheduledJob parancsmag törli az ütemezett feladatokat a helyi számítógépről.

Ha töröl vagy töröl egy ütemezett feladatot, Unregister-ScheduledJob törli az ütemezett feladat könyvtárát (a $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directoryfájlban), amely tartalmazza az ütemezett feladatot, a feladat végrehajtási előzményeit és az összes feladat eredményét meghatározó XML-fájlt. Ez a művelet a feladatot a Feladatütemezőből is törli.

Unregister-ScheduledJob csak a parancsmaggal Register-ScheduledJob létrehozott ütemezett feladatokat törli. Nem törli a Feladatütemezőben létrehozott ütemezett feladatokat.

Az ütemezett feladatok azonosító vagy név alapján történő törléséhez használhatja az ütemezett feladatok paramétereitUnregister-ScheduledJob, illetve a pipa ütemezett feladataitUnregister-ScheduledJob.Get-ScheduledJob

Unregister-ScheduledJob a Windows PowerShellben található PSScheduledJob modul feladatütemezési parancsmagjainak egyik gyűjteménye.

Az ütemezett feladatokról további információt a PSScheduledJob modul Témakörök című témakörében talál. Importálja a PSScheduledJob modult, majd írja be a következőt: Get-Help about_Scheduled* vagy tekintse meg a about_Scheduled_Jobs.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Ütemezett feladat törlése

Unregister-ScheduledJob TestJob

Ez a parancs törli a TestJob ütemezett feladatát a helyi számítógépen.

2. példa: Az összes ütemezett feladat törlése

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

Ez a példa két különböző parancsot mutat be, amelyek törlik az összes ütemezett feladatot a helyi számítógépen.

Az első parancs a parancsmagot használja az Get-ScheduledJob összes ütemezett feladat lekéréséhez a helyi számítógépen. A folyamatüzemeltető (|) elküldi az ütemezett feladatokat Unregister-ScheduleJob, amelyek törlik őket.

A második parancs az összes (*) értékkel rendelkező Név paramétert Unregister-ScheduledJob használja az összes ütemezett feladat törléséhez.

Mindkét parancs a Force paramétert használja, amely akkor is törli az ütemezett feladatokat, ha a feladat egy példánya fut.

3. példa: Ütemezett feladat törlése távoli számítógépen

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

Ez a parancs törli a Server01 távoli számítógépen a Tesztelés paranccsal kezdődő, ütemezett feladatokat. A parancs a Invoke-Command parancsmaggal futtatja a Unregister-ScheduledJob parancsot a Server02 számítógépen.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Force

Akkor is törli az ütemezett feladatot, ha a feladat egy példánya fut. Alapértelmezés szerint nem szakítja meg a Unregister-ScheduledJob futó feladatokat.

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

-Id

Törli az ütemezett feladatokat a megadott azonosítószámokkal (id). Adja meg az ütemezett feladatok azonosítóit a számítógépen.

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

-InputObject

Ütemezett feladatot ad meg. Adjon meg egy változót, amely ScheduledJob-objektumokat tartalmaz, vagy írjon be egy parancsot vagy kifejezést, amely ScheduledJob-objektumokat( például parancsokatGet-ScheduledJob) kap. ScheduledJob-objektumokat is becsúszthat a programbaUnregister-JobTrigger.

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

-Name

Törli az ütemezett feladatokat a megadott névvel. Adja meg egy vagy több ütemezett feladat nevét a számítógépen. A helyettesítő karakterek támogatottak.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

ScheduledJobDefinition

Erre a parancsmagra ütemezett feladatokat is be lehet csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.