Remove-JobTrigger
Zamanlanmış işlerden iş tetikleyicilerini silin.
Sözdizimi
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.
Tür: | Int32[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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-JobTrigger
de yöneltebilirsiniz.
Tür: | ScheduledJobDefinition[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | String[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | Int32[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Zamanlanmış bir işi bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
İlişkili Bağlantılar
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Get-ScheduledJobOption
- Unregister-ScheduledJob
PowerShell