Udostępnij za pośrednictwem

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 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 polecenia cmdlet Get-JobTrigger, aby pobrać wyzwalacze zadania. Następnie należy przekazać wyzwalacze zadania, aby disable-JobTrigger lub użyć jego 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 w celu $True. Wyłączenie wyzwalacza zadania nie powoduje wyłączenia zaplanowanego zadania, na przykład przez 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 dołączony do programu 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

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

To polecenie wyłącza pierwszy wyzwalacz (ID=1) Backup-Archives zaplanowanego zadania 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, co powoduje jego wyłączenie.

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 wyzwalacze codziennego 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.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 scheduledJobTrigger obiektów, takich jak Get-JobTrigger polecenia. Możesz również przekazać obiekt ScheduledJobTrigger, aby disable-JobTrigger.

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

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ScheduledJobTrigger

Wyzwalacze zadań można potokować, aby 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.