Enable-JobTrigger

  • Reference
Modul:
PSScheduledJob

Povolí triggery úloh naplánovaných úloh.

Syntax

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

Description

Rutina Enable-JobTrigger znovu povolí triggery úloh naplánovaných úloh, například těch, které byly zakázány pomocí rutiny Disable-JobTrigger . Povolené a znovu povolené triggery úloh mohou okamžitě spouštět naplánované úlohy; Není potřeba restartovat Windows ani Windows PowerShell.

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 Enable-JobTrigger nebo použijte jeho inputObject parametr.

Chcete-li povolit trigger úlohy, Enable-JobTrigger rutina nastaví vlastnost Enabled trigger úlohy na $true.

Enable-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: Povolení triggeru úlohy

Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

Tento příkaz povolí první aktivační událost (ID=1) naplánované úlohy zálohování archivů na místním počítači.

Příkaz použije rutinu Get-JobTrigger k získání triggeru úlohy. Operátor kanálu odešle trigger úlohy do Enable-JobTrigger rutiny, která ji povolí.

Příklad 2: Povolení všech triggerů úloh

Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

Příkaz pomocí rutiny Get-ScheduledJob získá naplánované úlohy na místním počítači. 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 Enable-JobTrigger rutiny, která je povolí.

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

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

Tento příkaz znovu povolí triggery úlohy AtLogon na plánované úloze DeployPackage na vzdáleném počítači Serveru01.

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 triggery úlohy AtLogon. Operátor kanálu odešle triggery úlohy AtLogon do Enable-JobTrigger rutiny, která je povolí.

Příklad 4: Zobrazení zakázaných aktivačních událostí úlohy

Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
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

Tento příkaz zobrazí všechny zakázané triggery úloh všech naplánovaných úloh v tabulce. K zjišťování triggerů úloh, které můžou být potřeba povolit, můžete použít příkaz podobný tomuto příkazu.

Příkaz pomocí rutiny Get-ScheduledJob získá naplánované úlohy na místním počítači. 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 aktivační události úlohy do Where-Object rutiny, která vrací pouze triggery úloh, které jsou zakázané, to znamená, že hodnota vlastnosti Enabled aktivační události úlohy není (!) true.

Jiný operátor kanálu odešle do rutiny triggery Format-Table zakázané úlohy, která zobrazí vybrané vlastnosti triggerů úlohy v tabulce. Vlastnosti zahrnují novou vlastnost JobName, která zobrazuje název naplánované úlohy ve vlastnosti JobDefinition triggeru úlohy.

Parametry

-Confirm

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

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

-InputObject

Určuje trigger úlohy, který se má povolit. 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 Enable-JobTriggerobjekt .

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

Vstupy

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

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

Výstupy

None

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

Poznámky

  • Enable-JobTrigger negeneruje chyby nebo upozornění, pokud povolíte trigger úlohy, který je již povolený.