Sdílet prostřednictvím

Disable-JobTrigger

  • Reference
Modul:
PSScheduledJob

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

Syntax

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

Description

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

Pokud chcete použít tuto rutinu, použijte k získání triggerů úloh rutinu Get-JobTrigger. Pak předejte triggery úlohy na Disable-JobTrigger nebo použijte jeho parametr InputObject .

Pokud chcete zakázat trigger úlohy, rutina Disable-JobTrigger nastaví vlastnost Enabled triggeru ú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ím triggeru úlohy se naplánovaná úloha nezakáže, například rutina Disable-ScheduledJob, 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 naplánované úlohy, můžete úlohu 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 PowerShell.

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

Tato rutina byla zavedena v Windows PowerShell 3.0.

Příklady

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

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

Tento příkaz zakáže první aktivační událost (ID=1) Backup-Archives naplánované úlohy v místním počítači.

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

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

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

Tyto příkazy zakážou všechny triggery úloh u dvou naplánovaných úloh a zobrazí výsledky.

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

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

Tento příkaz zakáže aktivační události denní úlohy v naplánované úloze DeployPackage na vzdáleném počítači Server01.

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ů úloh naplánované úlohy DeployPackage. Operátor kanálu odesílá triggery úlohy do rutiny Where-Object, která vrací pouze triggery úloh za den. Operátor kanálu odesílá triggery denních úloh do rutiny Disable-JobTrigger , 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Určuje aktivační událost úlohy, která se má zakázat. Zadejte proměnnou, která obsahuje objekty ScheduledJobTrigger , nebo zadejte příkaz nebo výraz, který získá objekty ScheduledJobTrigger , například Get-JobTrigger příkaz. Můžete také předvést ScheduledJobTriggerobjektu Disable-JobTrigger.

Type: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:False
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

ScheduledJobTrigger

Triggery úloh můžete předát do rutiny Disable-JobTrigger.

Výstupy

None

Tato rutina negeneruje žádný výstup.

Poznámky

  • Disable-JobTrigger negeneruje chyby ani upozornění, pokud zakážete aktivační událost úlohy, která je už zakázaná.