Disable-JobTrigger

  • Odwołanie
Moduł:
PSScheduledJob

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 powoduje zachowanie wszystkich 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ć wyzwalacze 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 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 Start-Job polecenia cmdlet lub użyć wyłączonego zaplanowanego zadania jako szablonu.

Disable-ScheduledJob 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. 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 Get-ScheduledJob polecenia cmdlet do pobrania Backup-Archives zaplanowanych zadań i Inventory. 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 wyzwalacze codziennego 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 do pobrania wyzwalaczy zadania zaplanowanego deployPackage. Operator potoku wysyła wyzwalacze zadania do Where-Object polecenia cmdlet, które zwraca tylko codzienne wyzwalacze zadania. Operator potoku wysyła wyzwalane codzienne zadanie do Disable-JobTrigger 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Określa wyzwalacz zadania, który ma być wyłączony. 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: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 żadnych danych wyjściowych.

Type:SwitchParameter
Position:Named
Default value:None
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

ScheduledJobTrigger

Możesz przekazać wyzwalacz zadania do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca ż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.