Remove-JobTrigger

  • Referencia
Modul:
PSScheduledJob

Feladat-eseményindítók törlése ütemezett feladatokból.

Syntax

Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-InputObject] <ScheduledJobDefinition[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Name] <String[]>
      [<CommonParameters>]

Description

A Remove-JobTrigger parancsmag törli a feladat-eseményindítókat az ütemezett feladatokból.

A feladat-eseményindítók ismétlődő ütemezést vagy feltételeket határoznak meg az ütemezett feladatok indításához. A feladat-eseményindítók kezeléséhez használja a New-JobTrigger, az Add-JobTrigger, a Set-JobTrigger és Set-ScheduledJob a parancsmagokat.

A Név, azonosító vagy InputObject paraméter használatával azonosíthatja Remove-JobTrigger azokat az ütemezett feladatokat, amelyekből az eseményindítók el lettek távolítva. A TriggerID paraméter használatával azonosíthatja a törölni kívánt feladat-eseményindítókat. Alapértelmezés szerint Remove-JobTrigger törli az ütemezett feladatok összes feladat-eseményindítóját.

Remove-JobTrigger 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: Az összes feladat-eseményindító törlése

Remove-JobTrigger -Name "Test*"

Ez a parancs törli az összes feladat-eseményindítót az ütemezett feladatból, amelynek neve a Tesztelés kezdetű.

2. példa: Kijelölt feladat-eseményindítók törlése

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Ez a parancs csak a harmadik eseményindítót (ID = 3) törli a BackupArchive ütemezett feladatból.

3. példa: AtStartup-feladat eseményindítóinak törlése az összes ütemezett feladatból

function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

Ez a függvény törli az összes AtStartup-feladat-eseményindítót a helyi számítógépen lévő összes feladatból. A függvény használatához futtassa a függvényt a munkamenetben, majd írja be a következőt Delete-AtStartup:

A Delete-AtStartup függvény egyetlen parancsot tartalmaz. A parancs a Get-ScheduledJob parancsmaggal lekéri az ütemezett feladatokat a helyi számítógépen. A folyamatüzemeltető (|) elküldi az ütemezett feladatokat a Get-JobTrigger parancsmagnak, amely lekéri az összes feladat-eseményindítót az egyes ütemezett feladatokból. A folyamatüzemeltető elküldi a feladat-eseményindítókat a Where-Object parancsmagnak, amely kiválasztja azokat a feladat-eseményindítókat, amelyeknél a feladat-eseményindító Gyakoriság tulajdonságának értéke atStartup értékkel egyenlő.

A JobTrigger-objektumok rendelkeznek egy JobDefinition tulajdonságmal, amely tartalmazza az általuk aktivált ütemezett feladatot. A parancs fennmaradó része ezt az értékes funkciót használja.

A folyamatüzemeltető elküldi az AtStartup-feladat eseményindítóit a ForEach-Object parancsmagnak, amely minden AtStartup-eseményindítón futtat egy Remove-JobTrigger parancsot. Az InputObject paraméter Remove-JobTrigger értéke a feladat-eseményindító JobDefinition tulajdonságában szereplő ütemezett feladat. A TriggerID paraméter értéke a feladat-eseményindító azonosítótulajdonságában szereplő azonosító.

4. példa: Feladat-eseményindító törlése távoli ütemezett feladatból

Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Ez a parancs törli az első feladatindítót a Server01 számítógépen található Inventory feladatból.

A parancs a Invoke-Command parancsmag használatával futtatja a Remove-JobTrigger parancsmagot a Server01 számítógépen. A Remove-JobTrigger parancsmag az ID paramétert használja az Inventory ütemezett feladat és az Eseményindítóazonosító paraméter azonosítására az első eseményindító megadásához. Az azonosító paraméter különösen akkor hasznos, ha több ütemezett feladat neve azonos vagy hasonló.

Paraméterek

-Id

Megadja az ütemezett feladatok azonosítószámait. Remove-JobTrigger törli a feladat-eseményindítókat a megadott ütemezett feladatokból.

A helyi számítógépen vagy távoli számítógépen ütemezett feladatok azonosítószámának lekéréséhez használja a Get-ScheduledJob parancsmagot.

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

-InputObject

Megadja az ütemezett feladatokat. 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 programbaRemove-JobTrigger.

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

-Name

Megadja az ütemezett feladatok nevét. Remove-JobTrigger törli a feladat-eseményindítókat a megadott ütemezett feladatokból. A helyettesítő karakterek támogatottak.

Ha le szeretné szerezni az ütemezett feladatok nevét a helyi számítógépen vagy egy távoli számítógépen, használja a Get-ScheduledJob parancsmagot.

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

-TriggerId

Csak a megadott feladat-eseményindítókat törli. Alapértelmezés szerint Remove-JobTrigger törli az összes eseményindítót az ütemezett feladatokból. Ezt a paramétert akkor használja, ha az ütemezett feladatok több feladat-eseményindítóval rendelkeznek.

Adja meg egy ütemezett feladat egy vagy több feladat-eseményindítójának triggerazonosítóit. Ha több ütemezett feladatot ad meg, Remove-JobTrigger az összes ütemezett feladatból törli a megadott azonosítóval rendelkező feladat-eseményindítót.

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

Bevitelek

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

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

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.