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[]>]
      [-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 wyzwalacze są usuwane. Użyj parametru TriggerID , aby zidentyfikować wyzwalacze zadania do usunięcia. Domyślnie Remove-JobTrigger usuwa wszystkie wyzwalacze zadania zaplanowanego.

Remove-JobTrigger jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który znajduje się 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

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

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 pobrania 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, które wyzwalają. 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 InputObject parametru Remove-JobTrigger 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 z 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
Required:True
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
Required:True
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
Required:True
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 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ń.

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

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Możesz przekazać zaplanowane zadanie do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.