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 jobbets utlösare till Disable-JobTrigger eller använd dess InputObject-parameter .

Om du vill inaktivera en jobbutlösare Disable-JobTrigger anger cmdleten egenskapen Aktiverad för jobbutlösaren till $False. Om du vill återaktivera jobbutlösaren använder du cmdleten Enable-JobTrigger , som anger den aktiverade egenskapen 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 Inventeringsjobben. En pipelineoperator (|) skickar de schemalagda jobben 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 dess namnparameter tar flera namn.

Det andra kommandot visar resultatet. Kommandot upprepar Get-ScheduledJob kommandot 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PassThru

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

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

-WhatIf

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

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

Indata

Microsoft.PowerShell.ScheduledJob.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 inte fel eller varningar om du inaktiverar en jobbutlösare som redan är inaktiverad.