Disable-JobTrigger

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

Syntax

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

Description

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

Pokud chcete tuto rutinu použít, použijte tuto rutinu Get-JobTrigger k získání triggerů úloh. Potom předejte triggery Disable-JobTrigger úlohy do parametru InputObject nebo ho použijte.

Chcete-li zakázat trigger úlohy, Disable-JobTrigger rutina nastaví povolenou vlastnost triggeru úlohy na $False. Pokud chcete trigger úlohy znovu povolit, použijte rutinu Enable-JobTrigger , která nastaví vlastnost Enabled aktivační události úlohy na $True. Zakázání triggeru úlohy nezakazuje naplánovanou úlohu, například ji provádí Disable-ScheduledJob rutina, ale pokud zakážete všechny triggery úloh, bude efekt 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 úlohu spustit pomocí Start-Job rutiny nebo jako šablonu použít zakázanou naplánovanou úlohu.

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

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

Tato rutina byla zavedena v Windows PowerShell 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 trigger ú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 inventarizaci. Operátor kanálu (|) odešle naplánované úlohy do Get-JobTrigger rutiny, která získá všechny triggery ú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 použije rutinu Get-ScheduledJob k získání úloh, 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 úloh 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 triggery denních úloh pro naplánovanou úlohu na 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 používá rutinu Get-JobTrigger k získání triggerů úlohy naplánované úlohy DeployPackage. Operátor kanálu odešle triggery úlohy do Where-Object rutiny, která vrací pouze denní triggery úloh. Operátor kanálu odešle do rutiny triggery Disable-JobTrigger každodenní úlohy, které je zakáže.

Parametry

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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é převést objekt Disable-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

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

-WhatIf

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

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

Vstupy

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Aktivační události úlohy můžete převést na Disable-JobTrigger.

Výstupy

None

Tato rutina negeneruje žádný výstup.

Poznámky

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