Dela via

Disable-JobTrigger

  • Referens
Modul:
PSScheduledJob

Inaktiverar jobbutlösare för schemalagda jobb.

Syntax

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

Description

Cmdleten Disable-JobTrigger inaktiverar tillfälligt jobbutlösare för schemalagda jobb. Om du inaktiverar bevaras alla egenskaper för jobbutlösare, men det förhindrar att jobbutlösaren startar det schemalagda jobbet.

Om du vill använda den här cmdleten använder du cmdleten Get-JobTrigger för att hämta jobbutlösarna. Skicka sedan jobbutlösarna för att Disable-JobTrigger eller använda parametern InputObject.

Om du vill inaktivera en jobbutlösare anger cmdleten Disable-JobTrigger egenskapen Enabled för jobbutlösaren till $False. Om du vill återaktivera jobbutlösaren använder du cmdleten Enable-JobTrigger, som anger aktiverad egenskap för jobbutlösaren till $True. Om du inaktiverar en jobbutlösare inaktiveras inte det schemalagda jobbet, till exempel genom cmdleten Disable-ScheduledJob, men om du inaktiverar alla jobbutlösare är effekten samma som att inaktivera det schemalagda jobbet.

Om du inaktiverar ett schemalagt jobb eller inaktiverar alla jobbutlösare för ett schemalagt jobb kan du fortfarande starta jobbet med hjälp av cmdleten Start-Job eller använda det inaktiverade schemalagda jobbet som en mall.

Disable-ScheduledJob är en av en samling cmdletar för jobbschemaläggning i modulen PSScheduledJob som ingår i Windows PowerShell.

Mer information om schemalagda jobb finns i Avsnittet om i modulen PSScheduledJob. Importera modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Inaktivera en jobbutlösare

Det här exemplet inaktiverar den första utlösaren ett schemalagt jobb på den lokala datorn.

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

Kommandot använder cmdleten Get-JobTrigger för att hämta jobbutlösaren. En pipelineoperator (|)skickar jobbutlösaren till cmdleten Disable-JobTrigger, vilket inaktiverar den.

Exempel 2: Inaktivera alla jobbutlösare

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

Det första kommandot använder cmdleten Get-ScheduledJob för att hämta de schemalagda jobben Backup-Archives och Inventory. En pipelineoperator (|) skickar schemalagda jobb till cmdleten Get-JobTrigger, som hämtar alla jobbutlösare för de schemalagda jobben. En annan pipelineoperator skickar jobbutlösare till cmdleten Disable-JobTrigger, vilket inaktiverar dem. Det första kommandot använder cmdleten Get-ScheduledJob för att hämta jobben, eftersom parametern Name tar flera namn.

Det andra kommandot visar resultatet. Kommandot upprepar kommandot Get-ScheduledJob och Get-JobTrigger. En pipelineoperator skickar jobbutlösare till cmdleten Format-Table, som visar jobbutlösare i en tabell. Kommandot Format-Table lägger till en JobName-egenskap som visar värdet för egenskapen Namn för det schemalagda jobbet i jobdefinitionsegenskapen för jobbutlösarobjektet.

Dessa kommandon inaktiverar alla jobbutlösare på två schemalagda jobb och visar resultatet.

Exempel 3: Inaktivera jobbutlösare för ett schemalagt jobb på en fjärrdator

Det här exemplet inaktiverar de dagliga jobbutlösarna för ett schemalagt jobb på en fjärrdator

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

Kommandot använder cmdleten Invoke-Command för att köra kommandona på Server01-datorn. Fjärrkommandot använder cmdleten Get-JobTrigger för att hämta jobbutlösare för det schemalagda jobbet DeployPackage. En pipelineoperator skickar jobbutlösare till cmdleten Where-Object, som endast returnerar dagliga jobbutlösare. En pipelineoperator skickar de dagliga jobbutlösarna till cmdleten Disable-JobTrigger, vilket inaktiverar dem.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger den jobbutlösare som ska inaktiveras. Ange en variabel som innehåller ScheduledJobTrigger objekt eller skriv ett kommando eller uttryck som hämtar ScheduledJobTrigger objekt, till exempel ett Get-JobTrigger kommando. Du kan också skicka ett ScheduledJobTrigger- objekt till Disable-JobTrigger.

Typ:ScheduledJobTrigger[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ScheduledJobTrigger

Du kan skicka en jobbutlösare till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

  • Disable-JobTrigger genererar inga fel eller varningar om du inaktiverar en jobbutlösare som redan är inaktiverad.