Remove-JobTrigger

  • Başvuru
Modül:
PSScheduledJob

Zamanlanmış işlerden iş tetikleyicilerini silin.

Syntax

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

Description

Remove-JobTrigger Cmdlet, zamanlanmış işlerden iş tetikleyicilerini siler.

İş tetikleyicisi, yinelenen bir zamanlamayı veya zamanlanmış işi başlatma koşullarını tanımlar. İş tetikleyicilerini yönetmek için New-JobTrigger, Add-JobTrigger, Set-JobTrigger ve Set-ScheduledJob cmdlet'lerini kullanın.

Tetikleyicilerin kaldırıldığı zamanlanmış işleri tanımlamak için name, id veya InputObject parametrelerini Remove-JobTrigger kullanın. Silinecek iş tetikleyicilerini tanımlamak için TriggerID parametresini kullanın. Varsayılan olarak, Remove-JobTrigger zamanlanmış bir işin tüm iş tetikleyicilerini siler.

Remove-JobTrigger , Windows PowerShell'de bulunan PSScheduledJob modülündeki iş zamanlama cmdlet'leri koleksiyonundan biridir.

Zamanlanmış İşler hakkında daha fazla bilgi için PSScheduledJob modülündeki Hakkında konu başlıklarına bakın. PSScheduledJob modülünü içeri aktarın ve şunu yazın: Get-Help about_Scheduled* veya about_Scheduled_Jobs bakın.

Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1: Tüm iş tetikleyicilerini silme

Remove-JobTrigger -Name "Test*"

Bu komut, Test ile başlayan adları olan zamanlanmış işten tüm iş tetikleyicilerini siler.

Örnek 2: Seçili iş tetikleyicilerini silme

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Bu komut BackupArchive zamanlanmış işinden yalnızca üçüncü tetikleyiciyi (ID = 3) siler.

Örnek 3: Tüm zamanlanmış işlerden AtStartup işi tetikleyicilerini silme

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

Bu işlev, yerel bilgisayardaki tüm işlerden tüm AtStartup işi tetikleyicilerini siler. işlevini kullanmak için, işlevi oturumunuzda çalıştırın ve yazın Delete-AtStartup.

İşlev tek Delete-AtStartup bir komut içerir. Komut, yerel bilgisayarda zamanlanmış işleri almak için cmdlet'ini kullanır Get-ScheduledJob . İşlem hattı işleci (|), zamanlanmış işleri cmdlet'ine Get-JobTrigger gönderir ve zamanlanan işlerin her birinden tüm iş tetikleyicilerini alır. İşlem hattı işleci, iş tetikleyicilerini cmdlet'ine Where-Object gönderir ve iş tetikleyicisinin Frequency özelliğinin değeri AtStartup'a eşit olduğunda iş tetikleyicilerini seçer.

JobTrigger nesneleri, tetikledikleri zamanlanmış işi içeren bir JobDefinition özelliğine sahiptir. Komutun geri kalanı bu değerli özelliği kullanır.

İşlem hattı işleci, her AtStartup tetikleyicisinde bir Remove-JobTrigger komut çalıştıran cmdlet'ine AtStartup iş tetikleyicilerini ForEach-Object gönderir. InputObject parametresinin Remove-JobTrigger değeri, iş tetikleyicisinin JobDefinition özelliğindeki zamanlanmış iştir. TriggerID parametresinin değeri, iş tetikleyicisinin ID özelliğindeki tanımlayıcıdır.

Örnek 4: Uzak zamanlanmış bir işten iş tetikleyicisi silme

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

Bu komut, Server01 bilgisayarındaki Inventory işinden ilk iş tetikleyicisini siler.

komut, cmdlet'ini Remove-JobTrigger Server01 bilgisayarında çalıştırmak için cmdlet'ini kullanırInvoke-Command. Cmdlet, Remove-JobTrigger Envanter zamanlanmış işini tanımlamak için ID parametresini ve ilk tetikleyiciyi belirtmek için TriggerID parametresini kullanır. Id parametresi, özellikle birden çok zamanlanmış işin adları aynı veya benzer olduğunda kullanışlıdır.

Parametreler

-Id

Zamanlanan işlerin kimlik numaralarını belirtir. Remove-JobTrigger belirtilen zamanlanmış işlerden iş tetikleyicilerini siler.

Yerel bilgisayarda veya uzak bilgisayarda zamanlanmış işlerin kimlik numarasını almak için cmdlet'ini Get-ScheduledJob kullanın.

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

-InputObject

Zamanlanmış işleri belirtir. ScheduledJob nesnelerini içeren bir değişken girin veya komut gibi ScheduledJob nesnelerini alan bir Get-ScheduledJob komut veya ifade yazın. ScheduledJob nesnelerini öğesine Remove-JobTriggerde yöneltebilirsiniz.

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

-Name

Zamanlanan işlerin adlarını belirtir. Remove-JobTrigger belirtilen zamanlanmış işlerden iş tetikleyicilerini siler. Joker karakterler desteklenir.

Yerel bilgisayarda veya uzak bilgisayarda zamanlanmış işlerin adlarını almak için cmdlet'ini Get-ScheduledJob kullanın.

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

-TriggerId

Yalnızca belirtilen iş tetikleyicilerini siler. Varsayılan olarak, Remove-JobTrigger zamanlanmış işlerden tüm tetikleyicileri siler. Zamanlanan işlerin birden çok iş tetikleyicisi olduğunda bu parametreyi kullanın.

Zamanlanmış işin bir veya daha fazla iş tetikleyicisinin tetikleyici kimliklerini girin. Birden çok zamanlanmış iş belirtirseniz, Remove-JobTrigger tüm zamanlanmış işlerden belirtilen kimlikle iş tetikleyicisini siler.

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

Girişler

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Zamanlanmış bir işi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.