Remove-JobTrigger

Usuń wyzwalacze zadań z zaplanowanych zadań.

Składnia

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

Opis

Polecenie Remove-JobTrigger cmdlet usuwa wyzwalacze zadań z zaplanowanych zadań.

Wyzwalacz zadania definiuje cykliczny harmonogram lub warunki uruchamiania zaplanowanego zadania. Aby zarządzać wyzwalaczami zadań, użyj poleceń cmdlet New-JobTrigger, Add-JobTrigger, Set-JobTrigger.Set-ScheduledJob

Użyj parametrów Name, ID lub InputObject , Remove-JobTrigger aby zidentyfikować zaplanowane zadania, z których są usuwane wyzwalacze. Użyj parametru TriggerID , aby zidentyfikować wyzwalacze zadania do usunięcia. Domyślnie Remove-JobTrigger usuwa wszystkie wyzwalacze zadania zaplanowanego.

Remove-JobTriggerjest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który jest uwzględniony w Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz polecenie: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w Windows PowerShell 3.0.

Przykłady

Przykład 1. Usuwanie wszystkich wyzwalaczy zadań

Remove-JobTrigger -Name "Test*"

To polecenie usuwa wszystkie wyzwalacze zadania z zaplanowanego zadania, które mają nazwy rozpoczynające się od testu.

Przykład 2. Usuwanie wybranych wyzwalaczy zadań

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

To polecenie usuwa tylko trzeci wyzwalacz (identyfikator = 3) z zaplanowanego zadania BackupArchive.

Przykład 3. Usuwanie wyzwalaczy zadania AtStartup ze wszystkich zaplanowanych zadań

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

Ta funkcja usuwa wszystkie wyzwalacze zadania AtStartup ze wszystkich zadań na komputerze lokalnym. Aby użyć funkcji, uruchom funkcję w sesji, a następnie wpisz Delete-AtStartup.

Funkcja Delete-AtStartup zawiera jedno polecenie. Polecenie używa Get-ScheduledJob polecenia cmdlet do pobierania zaplanowanych zadań na komputerze lokalnym. Operator potoku (|) wysyła zaplanowane zadania do Get-JobTrigger polecenia cmdlet, które pobiera wszystkie wyzwalacze zadania z każdego zaplanowanego zadania. Operator potoku wysyła wyzwalacze zadania do Where-Object polecenia cmdlet, które wybiera wyzwalacze zadania, gdzie wartość właściwości Frequency wyzwalacza zadania jest równa AtStartup.

Obiekty JobTrigger mają właściwość JobDefinition zawierającą zaplanowane zadanie wyzwalane. Pozostała część polecenia używa tej cennej funkcji.

Operator potoku wysyła wyzwalacze zadania AtStartup do ForEach-Object polecenia cmdlet, które uruchamia Remove-JobTrigger polecenie na każdym wyzwalaczu AtStartup. Wartość parametru Remove-JobTrigger InputObject obiektu to zaplanowane zadanie we właściwości JobDefinition wyzwalacza zadania. Wartość parametru TriggerID jest identyfikatorem we właściwości ID wyzwalacza zadania.

Przykład 4. Usuwanie wyzwalacza zadania ze zdalnego zaplanowanego zadania

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

To polecenie usuwa pierwszy wyzwalacz zadania z zadania spisu na komputerze Server01.

Polecenie używa Invoke-Command polecenia cmdlet do uruchomienia Remove-JobTrigger polecenia cmdlet na komputerze Server01. Polecenie Remove-JobTrigger cmdlet używa parametru ID do identyfikowania zaplanowanego zadania spisu i parametru TriggerID w celu określenia pierwszego wyzwalacza. Parametr ID jest szczególnie przydatny, gdy wiele zaplanowanych zadań ma takie same lub podobne nazwy.

Parametry

-Id

Określa numery identyfikacyjne zaplanowanych zadań. Remove-JobTrigger usuwa wyzwalacze zadań z określonych zaplanowanych zadań.

Aby uzyskać numer identyfikacyjny zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj Get-ScheduledJob polecenia cmdlet .

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

Określa zaplanowane zadania. Wprowadź zmienną zawierającą obiekty ScheduledJob lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJob , takie jak Get-ScheduledJob polecenie. Można również potokować obiekty ScheduledJob do Remove-JobTrigger.

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

Określa nazwy zaplanowanych zadań. Remove-JobTrigger usuwa wyzwalacze zadania z określonych zaplanowanych zadań. Obsługiwane są symbole wieloznaczne.

Aby uzyskać nazwy zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj Get-ScheduledJob polecenia cmdlet .

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

Usuwa tylko określone wyzwalacze zadania. Domyślnie Remove-JobTrigger usuwa wszystkie wyzwalacze z zaplanowanych zadań. Użyj tego parametru, gdy zaplanowane zadania mają wiele wyzwalaczy zadań.

Wprowadź identyfikatory wyzwalacza co najmniej jednego wyzwalacza zaplanowanego zadania. Jeśli określisz wiele zaplanowanych zadań, Remove-JobTrigger usuwa wyzwalacz zadania z określonym identyfikatorem ze wszystkich zaplanowanych zadań.

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

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Zaplanowane zadania można potokować Remove-JobTrigger do polecenia cmdlet.

Dane wyjściowe

Brak

Polecenie cmdlet nie generuje żadnych danych wyjściowych.