Udostępnij za pośrednictwem

Remove-JobTrigger

  • Odwołanie
Moduł:
PSScheduledJob

Usuwanie wyzwalaczy zadań z zaplanowanych zadań.

Składnia

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

Opis

Polecenie cmdlet Remove-JobTrigger 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 i Set-ScheduledJob.

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

remove-JobTrigger jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który jest zawarty w programie Windows PowerShell.

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

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

Przykłady

Przykład 1. Usuwanie wszystkich wyzwalaczy zadania

PS C:\> Remove-JobTrigger -Name "Test*"

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

Przykład 2. Usuwanie wybranych wyzwalaczy zadania

PS C:\> 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ń

PS C:\> 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 polecenia cmdlet Get-ScheduledJob w celu pobrania zaplanowanych zadań na komputerze lokalnym. Operator potoku (|) wysyła zaplanowane zadania do polecenia cmdlet Get-JobTrigger, które pobiera wszystkie wyzwalacze zadania z każdego z zaplanowanych zadań. Operator potoku wysyła wyzwalacze zadania do polecenia cmdlet Where-Object, które wybiera wyzwala 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, które wyzwalają. Pozostała część polecenia używa tej cennej funkcji.

Operator potoku wysyła wyzwalacze zadania AtStartup do polecenia cmdlet ForEach-Object, które uruchamia polecenie Remove-JobTrigger na każdym wyzwalaczu AtStartup. Wartość parametru InputObjectRemove-JobTrigger jest zaplanowanym zadaniem 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 z zdalnego zaplanowanego zadania

PS C:\> 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 polecenia cmdlet Invoke-Command do uruchomienia polecenia cmdlet Remove-JobTrigger na komputerze Server01. Polecenie cmdlet Remove-JobTrigger używa parametru identyfikatora do identyfikowania zaplanowanego zadania spisu oraz parametru triggerID TriggerID w celu określenia pierwszego wyzwalacza. Parametr identyfikatora 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 polecenia cmdlet Get-ScheduledJob.

Typ:Int32[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

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

Typ:ScheduledJobDefinition[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 polecenia cmdlet Get-ScheduledJob.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 wyzwalaczy co najmniej jednego wyzwalacza zaplanowanego zadania. Jeśli określisz wiele zaplanowanych zadań, Remove-JobTrigger usunie wyzwalacz zadania z określonym identyfikatorem ze wszystkich zaplanowanych zadań.

Typ:Int32[]
Position:Named
Domyślna wartość:All triggers
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ScheduledJobDefinition

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

Dane wyjściowe

None

Polecenie cmdlet nie generuje żadnych danych wyjściowych.