Disable-JobTrigger

Wyłącza wyzwalacze zadań zaplanowanych.

Składnia

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

Opis

Polecenie Disable-JobTrigger cmdlet 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 Get-JobTrigger polecenia cmdlet , aby pobrać wyzwalacze zadania. Następnie należy przekazać potok wyzwalaczy zadania do Disable-JobTrigger parametru InputObject lub użyć go.

Aby wyłączyć wyzwalacz zadania, Disable-JobTrigger polecenie cmdlet ustawia właściwość Enabled wyzwalacza zadania na $False. Aby ponownie włączyć wyzwalacz zadania, użyj Enable-JobTrigger polecenia cmdlet , które ustawia właściwość Enabled wyzwalacza zadania na $True. Wyłączenie wyzwalacza zadania nie powoduje wyłączenia zaplanowanego zadania, takiego jak polecenie Disable-ScheduledJob cmdlet, ale jeśli wyłączysz wszystkie wyzwalacze zadań, 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 Start-Job polecenia cmdlet lub użyć wyłączonego zaplanowanego zadania jako szablonu.

Disable-ScheduledJobjest 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

Ten przykład wyłącza pierwszy wyzwalacz zaplanowanego zadania na komputerze lokalnym.

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

Polecenie używa Get-JobTrigger polecenia cmdlet do pobrania wyzwalacza zadania. Operator potoku (|)wysyła wyzwalacz zadania do Disable-JobTrigger polecenia cmdlet, co powoduje jego wyłączenie.

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

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
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

Pierwsze polecenie używa polecenia cmdlet do pobierania Get-ScheduledJobBackup-Archives zaplanowanych zadań i Spisu. Operator potoku (|) wysyła zaplanowane zadania do Get-JobTrigger polecenia cmdlet, które pobiera wszystkie wyzwalacze zadań zaplanowanych. Inny operator potoku wysyła wyzwalacze zadania do Disable-JobTrigger polecenia cmdlet, co powoduje ich wyłączenie. Pierwsze polecenie używa Get-ScheduledJob polecenia cmdlet do pobrania zadań, ponieważ jego parametr Name przyjmuje wiele nazw.

Drugie polecenie wyświetla wyniki. Polecenie powtarza Get-ScheduledJob polecenie i Get-JobTrigger . Operator potoku wysyła wyzwalacze zadania do Format-Table polecenia cmdlet, które wyświetla wyzwalacze zadania w tabeli. Polecenie Format-Table dodaje właściwość JobName, która wyświetla wartość właściwości Name zaplanowanego zadania we właściwości JobDefinition obiektu wyzwalacza zadania.

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

Ten przykład wyłącza codzienne wyzwalacze zadania dla zaplanowanego zadania na komputerze zdalnym

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

Polecenie używa Invoke-Command polecenia cmdlet do uruchamiania poleceń na komputerze Server01. Zdalne polecenie używa Get-JobTrigger polecenia cmdlet, aby pobrać wyzwalacze zadania zaplanowanego zadania DeployPackage. Operator potoku wysyła wyzwalacze zadania do Where-Object polecenia cmdlet, które zwraca tylko codzienne wyzwalacze zadań. Operator potoku wysyła wyzwalacze codziennego Disable-JobTrigger zadania do polecenia cmdlet, co powoduje ich wyłączenie.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value: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 Get-JobTrigger polecenie. Możesz również przekazać potok obiektu ScheduledJobTrigger do Disable-JobTriggerobiektu .

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger[]
Position:0
Default value:None
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:None
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
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

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

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.