Sdílet prostřednictvím

Enable-ScheduledJob

  • Reference
Modul:
PSScheduledJob

Povolí naplánovanou úlohu.

Syntaxe

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

Rutina Enable-ScheduledJob znovu povolí naplánované úlohy, které jsou zakázané, například ty, které jsou zakázané pomocí rutiny Disable-ScheduledJob. Povolené úlohy se spouští automaticky při aktivaci.

Pokud chcete povolit naplánovanou úlohu, rutina Enable-ScheduledJob nastaví vlastnost Enabled naplánované úlohy na $True.

Enabled-ScheduledJob je jednou z kolekcí rutin plánování úloh v modulu PSScheduledJob, který je součástí prostředí Windows PowerShell.

Další informace o naplánovaných úlohách naleznete v tématu o tématech v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo viz about_Scheduled_Jobs.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Povolení naplánované úlohy

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

Tento příkaz povolí naplánovanou úlohu s ID 2 v místním počítači. Výstup ukazuje účinek příkazu.

Příklad 2: Povolení všech naplánovaných úloh

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

Tento příkaz povolí všechny naplánované úlohy v místním počítači. Používá rutinu Get-ScheduledJob k získání všech naplánovaných úloh a rutiny Enable-ScheduledJob k jejich povolení.

povolení naplánované úlohy nevygeneruje upozornění nebo chyby, pokud povolíte naplánovanou úlohu, která je už povolená, takže můžete povolit všechny naplánované úlohy bez podmínek.

Příklad 3: Povolení vybraných naplánovaných úloh

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

Tento příkaz umožňuje naplánované úlohy, které nevyžadují síťové připojení.

Příkaz používá rutinu Get-ScheduledJob k získání všech naplánovaných úloh v počítači. Operátor kanálu odešle naplánované úlohy do rutiny Get-ScheduledJobOption, která získá možnosti úlohy každé naplánované úlohy. Každý objekt možností úlohy má vlastnost JobDefinition, která obsahuje přidruženou naplánovanou úlohu. Vlastnost JobDefinition slouží k dokončení příkazu.

Příkaz pomocí operátoru kanálu (|) odešle možnosti úlohy do rutiny Where-Object, která vybere objekty možností naplánované úlohy, ve kterých má vlastnost RunWithoutNetwork hodnotu True ($true). Jiný operátor kanálu odešle vybrané objekty možností naplánované úlohy do rutiny ForEach-Object, která spouští příkaz Enable-ScheduledJob v naplánované úloze v hodnotě vlastnosti JobDefinition každého objektu možnosti úlohy.

Příklad 4: Povolení naplánovaných úloh ve vzdáleném počítači

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

Tento příkaz umožňuje naplánované úlohy, které mají ve svých názvech "test" na dvou vzdálených počítačích, Srv01 a Srv10.

Příkaz používá rutinu Invoke-Command ke spuštění příkazu Enable-ScheduledJob na počítačích Srv01 a Srv10. Příkaz pomocí parametru NameEnable-ScheduledJob povolí naplánovanou úlohu Inventory na každém počítači.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Povolí naplánovanou úlohu se zadaným identifikačním číslem (ID). Zadejte ID naplánované úlohy.

Typ:Int32
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje naplánovanou úlohu, která se má povolit. Zadejte proměnnou, která obsahuje ScheduledJobDefinition objekty nebo zadejte příkaz nebo výraz, který získá ScheduledJobDefinition objekty, například příkaz Get-ScheduledJob. Objekt ScheduledJobDefinition můžete takéEnable-ScheduledJob.

Typ:ScheduledJobDefinition
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Povolí naplánované úlohy se zadanými názvy. Zadejte název naplánované úlohy. Podporují se zástupné kóty.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

ScheduledJobDefinition

Naplánovanou úlohu můžete povolit naplánovanou úlohu.

Výstupy

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Pokud použijete parametr Passthru, enable-ScheduledJob vrátí povolenou naplánovanou úlohu. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • povolení naplánované úlohy nevygeneruje upozornění nebo chyby, pokud ji použijete k povolení naplánované úlohy, která už je povolená.