Disable-JobTrigger

  • Reference
Modul:
PSScheduledJob

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ím se zachová všechny vlastnosti triggeru úlohy, ale zabrání triggeru úlohy spustit naplánovanou úlohu.

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

Pokud chcete aktivační událost úlohy zakázat, rutina Disable-JobTrigger nastaví vlastnost Povolenou aktivační událost ú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 nezakazuje naplánovanou úlohu, například ji provádí rutina Disable-ScheduledJob, ale pokud zakážete všechny triggery úloh, efekt je 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 použít zakázanou naplánovanou úlohu jako šablonu.

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ématu Témata v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo si prohlédněte 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í trigger (ID=1) Backup-Archives naplánované úlohy na místním počítači.

Příkaz používá rutinu Get-JobTrigger k získání triggeru úlohy. Operátor kanálu odešle aktivační událost úlohy do rutiny Disable-JobTrigger , která ji 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 zakažou všechny triggery úloh ve dvou naplánovaných úlohách a zobrazí výsledky.

Příklad 3: Zakázání triggeru úlohy naplánované úlohy na 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 denní aktivační události úlohy 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 používá rutinu Get-JobTrigger k získání triggerů úlohy naplánované úlohy DeployPackage. Operátor kanálu odešle aktivační události úlohy do rutiny Where-Object, která vrací pouze denní triggery úloh. Operátor kanálu odešle aktivační události každodenní úlohy 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 obsahující objekty ScheduledJobTrigger nebo zadejte příkaz nebo výraz, který získá objekty ScheduledJobTrigger , například příkaz Get-JobTrigger. Můžete také řadit objekt ScheduledJobTrigger na 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

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Triggery úloh můžete řadit do funkce Disable-JobTrigger.

Výstupy

None

Tato rutina negeneruje žádný výstup.

Poznámky

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