Enable-ScheduledJob

Aktiverar ett schemalagt jobb.

Syntax

Enable-ScheduledJob
      [-InputObject] <ScheduledJobDefinition>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-ScheduledJob
      [-Id] <Int32>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-ScheduledJob
      [-Name] <String>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Enable-ScheduledJob återaktiverar schemalagda jobb som är inaktiverade, till exempel de som är inaktiverade med hjälp av cmdleten Disable-ScheduledJob. Aktiverade jobb körs automatiskt när de utlöses.

För att aktivera ett schemalagt jobb anger cmdleten Enable-ScheduledJob egenskapen Enabled för det schemalagda jobbet till $True.

Enabled-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: Aktivera ett schemalagt jobb

PS C:\> Enable-ScheduledJob -ID 2 -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True

Det här kommandot aktiverar det schemalagda jobbet med ID 2 på den lokala datorn. Utdata visar effekten av kommandot.

Exempel 2: Aktivera alla schemalagda jobb

PS C:\> Get-ScheduledJob | Enable-ScheduledJob -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        True
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     True
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       True

Det här kommandot aktiverar alla schemalagda jobb på den lokala datorn. Den använder cmdleten Get-ScheduledJob för att hämta alla schemalagda jobb och cmdleten Enable-ScheduledJob för att aktivera dem.

Enable-ScheduledJob inte genererar varningar eller fel om du aktiverar ett schemalagt jobb som redan är aktiverat, så att du kan aktivera alla schemalagda jobb utan villkor.

Exempel 3: Aktivera markerade schemalagda jobb

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} | ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

Det här kommandot aktiverar schemalagda jobb som inte kräver en nätverksanslutning.

Kommandot använder cmdleten Get-ScheduledJob för att hämta alla schemalagda jobb på datorn. En pipelineoperator skickar de schemalagda jobben till cmdleten Get-ScheduledJobOption, som hämtar jobbalternativen för varje schemalagt jobb. Varje jobbalternativobjekt har en JobDefinition-egenskap som innehåller det associerade schemalagda jobbet. Egenskapen JobDefinition används för att slutföra kommandot.

Kommandot använder en pipelineoperator (|) för att skicka jobbalternativen till cmdleten Where-Object, som väljer schemalagda jobbalternativobjekt där egenskapen RunWithoutNetwork har värdet True ($true). En annan pipelineoperator skickar de markerade objekten för schemalagda jobbalternativ till cmdleten ForEach-Object som kör ett Kommandot Enable-ScheduledJob på det schemalagda jobbet i värdet för egenskapen JobDefinition för varje jobbalternativobjekt.

Exempel 4: Aktivera schemalagda jobb på en fjärrdator

PS C:\> Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Det här kommandot aktiverar schemalagda jobb som har "test" i sina namn på två fjärrdatorer, Srv01 och Srv10.

Kommandot använder cmdleten Invoke-Command för att köra kommandot Enable-ScheduledJob på datorerna Srv01 och Srv10. Kommandot använder parametern Name för Enable-ScheduledJob för att aktivera det schemalagda inventeringsjobbet på varje dator.

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

-Id

Aktiverar det schemalagda jobbet med det angivna identifieringsnumret (ID). Ange ID för ett schemalagt jobb.

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

-InputObject

Anger det schemalagda jobb som ska aktiveras. Ange en variabel som innehåller ScheduledJobDefinition objekt eller skriv ett kommando eller uttryck som hämtar ScheduledJobDefinition objekt, till exempel ett Get-ScheduledJob kommando. Du kan också skicka ett ScheduledJobDefinition- objekt till Enable-ScheduledJob.

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

-Name

Aktiverar schemalagda jobb med de angivna namnen. Ange namnet på ett schemalagt jobb. Jokertecken stöds.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
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:False
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

ScheduledJobDefinition

Du kan skicka ett schemalagt jobb till Enable-ScheduledJob.

Utdata

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Om du använder parametern Passthru returnerar Enable-ScheduledJob det schemalagda jobb som har aktiverats. Annars genererar den här cmdleten inga utdata.

Kommentarer

  • Enable-ScheduledJob genererar inte varningar eller fel om du använder det för att aktivera ett schemalagt jobb som redan är aktiverat.