Sdílet prostřednictvím

Disable-JobTrigger

  • Reference
Modul:
PSScheduledJob

Zakáže triggery úlohy naplánovaných úloh.

Syntaxe

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

Description

Rutina Disable-JobTrigger dočasně zakáže triggery úloh naplánovaných úloh. Zakázání zachová všechny vlastnosti triggeru úlohy, ale zabrání triggeru úlohy spustit naplánovanou úlohu.

Pokud chcete tuto rutinu použít, použijte tuto rutinu Get-JobTrigger k získání aktivačních událostí úlohy. Pak předejte triggery úlohy do Disable-JobTrigger nebo použijte jeho inputObject parametr.

Chcete-li zakázat trigger úlohy, Disable-JobTrigger rutina nastaví vlastnost Enabled trigger úlohy na $False. Pokud chcete trigger úlohy znovu povolit, použijte rutinu Enable-JobTrigger , která nastaví vlastnost Enabled triggeru úlohy na $True. Zakázání triggeru úlohy nezakáže naplánovanou úlohu, jako je Disable-ScheduledJob například dokončení rutinou, ale pokud zakážete všechny triggery úloh, bude účinek stejný jako zakázání naplánované úlohy.

Pokud zakážete naplánovanou úlohu nebo zakážete všechny triggery úloh naplánované úlohy, můžete ji přesto spustit pomocí rutiny Start-Job nebo jako šablonu použít zakázanou naplánovanou úlohu.

Disable-ScheduledJob je jednou z kolekcí rutin plánování úloh v modulu PSScheduledJob , který je součástí Windows PowerShellu.

Další informace o naplánovaných úlohách naleznete v tématu o tématech v modulu PSScheduledJob. Naimportujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo se podívejte na about_Scheduled_Jobs.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Zakázání triggeru úlohy

Tento příklad zakáže první aktivaci naplánované úlohy v místním počítači.

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

Příkaz použije rutinu Get-JobTrigger k získání triggeru úlohy. Operátor kanálu (|)odešle aktivační událost úlohy do Disable-JobTrigger rutiny, která ji zakáže.

Příklad 2: Zakázání všech triggerů úloh

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

První příkaz pomocí rutiny Get-ScheduledJob získá Backup-Archives naplánované úlohy a úlohy Inventory. Operátor kanálu (|) odešle naplánované úlohy do Get-JobTrigger rutiny, která získá všechny aktivační události úloh naplánovaných úloh. Jiný operátor kanálu odešle triggery úlohy do Disable-JobTrigger rutiny, která je zakáže. První příkaz pomocí rutiny Get-ScheduledJob získá úlohy, protože jeho parametr Name přebírá více názvů.

Druhý příkaz zobrazí výsledky. Příkaz zopakuje Get-ScheduledJob příkaz a Get-JobTrigger příkaz. Operátor kanálu odešle triggery úlohy do Format-Table rutiny, která zobrazí triggery úlohy v tabulce. Příkaz Format-Table přidá vlastnost JobName, která zobrazí hodnotu Vlastnosti Name naplánované úlohy ve vlastnosti JobDefinition objektu triggeru úlohy.

Tyto příkazy zakazují všechny triggery úloh ve dvou naplánovaných úlohách a zobrazují výsledky.

Příklad 3: Zakázání triggeru úlohy naplánované úlohy na vzdáleném počítači

Tento příklad zakáže aktivační události každodenní úlohy pro naplánovanou úlohu ve vzdáleném počítači.

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

Příkaz používá rutinu Invoke-Command ke spuštění příkazů na počítači Server01. Vzdálený příkaz pomocí Get-JobTrigger rutiny získá aktivační události úlohy naplánované úlohy DeployPackage. Operátor kanálu odešle aktivační události úlohy do Where-Object rutiny, která vrací pouze denní aktivační události úlohy. Operátor kanálu odešle aktivační události každodenní úlohy do Disable-JobTrigger rutiny, která je zakáže.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje trigger úlohy, který se má zakázat. Zadejte proměnnou obsahující objekty ScheduledJobTrigger nebo zadejte příkaz nebo výraz, který získá objekty ScheduledJobTrigger, například Get-JobTrigger příkaz. Do objektu ScheduledJobTrigger lze také pipetovat Disable-JobTriggerobjekt .

Typ:ScheduledJobTrigger[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

ScheduledJobTrigger

Do této rutiny můžete spustit trigger úlohy.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

  • Disable-JobTrigger negeneruje chyby nebo upozornění, pokud zakážete trigger úlohy, který je již zakázán.