Unregister-ScheduledJob

  • Başvuru
Modül:
PSScheduledJob

Yerel bilgisayardaki zamanlanmış işleri siler.

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

Unregister-ScheduledJob Cmdlet zamanlanmış işleri yerel bilgisayardan siler.

Zamanlanmış bir işi sildiğinde veya kaydını kaldırdığında, Unregister-ScheduledJob zamanlanmış işi, iş yürütme geçmişini ve tüm iş sonuçlarını tanımlayan XML dosyasını içeren zamanlanmış işin dizinini ( $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directoryiçinde) siler. Bu eylem, görevi Görev Zamanlayıcı'dan da siler.

Unregister-ScheduledJob yalnızca cmdlet'i kullanılarak Register-ScheduledJob oluşturulan zamanlanmış işleri siler. Görev Zamanlayıcı'da oluşturulan zamanlanmış işleri silmez.

Kimliğine veya adına göre zamanlanmış işleri silmek ya da zamanlanmış işleri 'den adresine Get-ScheduledJob yöneltmek için parametresini Unregister-ScheduledJobUnregister-ScheduledJobkullanabilirsiniz.

Unregister-ScheduledJob , 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: Zamanlanmış işi silme

Unregister-ScheduledJob TestJob

Bu komut, yerel bilgisayardaki TestJob zamanlanmış işini siler.

Örnek 2: Zamanlanmış tüm işleri silme

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

Bu örnekte, yerel bilgisayardaki tüm zamanlanmış işleri silen iki farklı komut gösterilmektedir.

İlk komut, yerel bilgisayardaki tüm zamanlanmış işleri almak için cmdlet'ini kullanır Get-ScheduledJob . İşlem hattı işleci (|), zamanlanmış işleri Unregister-ScheduleJoböğesine gönderir ve bunları siler.

İkinci komut, tüm zamanlanmış işleri silmek için name parametresini Unregister-ScheduledJob tümü (*) değeriyle kullanır.

her iki komut da, işin bir örneği çalışıyor olsa bile zamanlanmış bir işi silen Force parametresini kullanır.

Örnek 3: Uzak bilgisayardaki zamanlanmış bir işi silme

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

Bu komut, Server01 uzak bilgisayarında Test ile başlayan adlara sahip zamanlanmış işleri siler. komutu Invoke-Command , cmdlet'ini Unregister-ScheduledJob kullanarak Server02 bilgisayarında komutunu çalıştırır.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Force

İşin bir örneği çalışıyor olsa bile zamanlanmış işi siler. Varsayılan olarak, Unregister-ScheduledJob çalışan işleri kesintiye uğratmaz.

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

-Id

Belirtilen kimlik numaralarına (Kimlik) sahip zamanlanmış işleri siler. Bilgisayarda zamanlanmış işlerin kimliklerini girin.

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

-InputObject

Zamanlanmış bir işi 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 Unregister-JobTriggerde yöneltebilirsiniz.

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

-Name

Belirtilen adlarla zamanlanmış işleri siler. Bilgisayardaki bir veya daha fazla zamanlanmış işin adını girin. Joker karakterler desteklenir.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

ScheduledJobDefinition

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

Çıkışlar

None

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