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

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 egenskapen Aktiverad för jobbutlösaren till $True. Om du inaktiverar en jobbutlösare inaktiveras inte det schemalagda jobbet, till exempel av 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 Om ämnen i modulen PSScheduledJob. Importera PSScheduledJob-modulen och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Denna cmdlet introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Inaktivera en jobbutlösare

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

Det här kommandot inaktiverar den första utlösaren (ID =1) för det Backup-Archives schemalagda jobbet på den lokala datorn.

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

Exempel 2: Inaktivera alla jobbutlösare

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

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

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

Det här kommandot inaktiverar de dagliga jobbutlösarna på det schemalagda Jobbet DeployPackage på fjärrdatorn Server01.

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 , som 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 jobbutlösaren 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: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 denna cmdlet inga utdata.

Type:SwitchParameter
Position:Named
Default value:False
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

ScheduledJobTrigger

Du kan skicka jobbutlösare till Disable-JobTrigger.

Utdata

None

Denna cmdlet genererar inga utdata.

Kommentarer

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