Disable-JobTrigger

  • Odwołanie
Moduł:
PSScheduledJob

Wyłącza wyzwalacze zadań zaplanowanych.

Składnia

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Opis

Polecenie cmdlet Disable-JobTrigger tymczasowo wyłącza wyzwalacze zadań zaplanowanych. Wyłączenie zachowuje wszystkie właściwości wyzwalacza zadania, ale uniemożliwia wyzwalaczowi zadania uruchamianie zaplanowanego zadania.

Aby użyć tego polecenia cmdlet, użyj polecenia cmdlet Get-JobTrigger, aby pobrać wyzwalacze zadania. Następnie należy przekazać potok wyzwalaczy zadania do polecenia Disable-JobTrigger lub użyć parametru InputObject .

Aby wyłączyć wyzwalacz zadania, polecenie cmdlet Disable-JobTrigger ustawia właściwość Enabled wyzwalacza zadania na $False. Aby ponownie włączyć wyzwalacz zadania, użyj polecenia cmdlet Enable-JobTrigger, które ustawia właściwość Enabled wyzwalacza zadania na $True. Wyłączenie wyzwalacza zadania nie powoduje wyłączenia zaplanowanego zadania, takiego jak polecenie cmdlet Disable-ScheduledJob, ale jeśli wyłączysz wszystkie wyzwalacze zadania, efekt jest taki sam jak wyłączenie zaplanowanego zadania.

Jeśli wyłączysz zaplanowane zadanie lub wyłączysz wszystkie wyzwalacze zaplanowanego zadania, nadal możesz uruchomić zadanie przy użyciu polecenia cmdlet Start-Job lub użyć wyłączonego zaplanowanego zadania jako szablonu.

Disable-ScheduledJob jest 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. Wyłączanie wyzwalacza zadania

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

To polecenie wyłącza pierwszy wyzwalacz (ID=1) zaplanowanego zadania Backup-Archives na komputerze lokalnym.

Polecenie używa polecenia cmdlet Get-JobTrigger w celu pobrania wyzwalacza zadania. Operator potoku wysyła wyzwalacz zadania do polecenia cmdlet Disable-JobTrigger , które go wyłącza.

Przykład 2. Wyłączanie wszystkich wyzwalaczy zadań

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Te polecenia wyłączają wszystkie wyzwalacze zadań dla dwóch zaplanowanych zadań i wyświetlają wyniki.

Przykład 3. Wyłączanie wyzwalacza zadania zaplanowanego na komputerze zdalnym

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

To polecenie wyłącza codzienne wyzwalacze zadania na zaplanowanym zadaniu DeployPackage na komputerze zdalnym Server01.

Polecenie używa polecenia cmdlet Invoke-Command do uruchamiania poleceń na komputerze Server01. Zdalne polecenie używa polecenia cmdlet Get-JobTrigger w celu pobrania wyzwalaczy zadania zaplanowanego zadania DeployPackage. Operator potoku wysyła wyzwalacze zadania do polecenia cmdlet Where-Object, które zwraca tylko codzienne wyzwalacze zadania. Operator potoku wysyła wyzwalacze codziennego zadania do polecenia cmdlet Disable-JobTrigger , które je wyłącza.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-InputObject

Określa wyzwalacz zadania do wyłączenia. Wprowadź zmienną zawierającą obiekty ScheduledJobTrigger lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJobTrigger , takie jak polecenie Get-JobTrigger. Możesz również przekazać potok obiektu ScheduledJobTrigger do polecenia Disable-JobTrigger.

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

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Wyzwalacze zadań potokowych można przekazać do polecenia Disable-JobTrigger.

Dane wyjściowe

None

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

Uwagi

  • Disable-JobTrigger nie generuje błędów ani ostrzeżeń, jeśli wyłączysz wyzwalacz zadania, który jest już wyłączony.