Sdílet prostřednictvím

Disable-ScheduledJob

  • Reference
Modul:
PSScheduledJob

Zakáže naplánovanou úlohu.

Syntaxe

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

Description

Rutina Disable-ScheduledJob dočasně zakáže naplánované úlohy. Zakázání zachovává všechny vlastnosti úlohy a nezakazuje aktivační události úlohy, ale zabrání automatickému spuštění naplánovaných úloh při aktivaci. Naplánovanou úlohu můžete spustit pomocí rutiny Start-Job nebo jako šablonu použít zakázanou naplánovanou úlohu.

Chcete-li zakázat naplánovanou úlohu, Disable-ScheduledJob rutina nastaví vlastnost Enabled naplánované úlohy na False. K opětovnému povolení naplánované úlohy použijte rutinu Enable-ScheduledJob .

Disable-ScheduledJob je jednou z kolekcí rutin plánování úloh v modulu PSScheduledJob , který je součástí Windows PowerShellu.

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

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Zakázání naplánované úlohy

Tento příklad zakáže naplánovanou úlohu v místním počítači.

Disable-ScheduledJob -ID 2 -PassThru

Tento příkaz zakáže naplánovanou úlohu s ID 2 v místním počítači.

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

Tento příklad zakáže všechny naplánované úlohy v místním počítači.

Get-ScheduledJob | Disable-ScheduledJob -PassThru

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        False
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     False
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       False

Rutina Get-ScheduledJob získá všechny naplánované úlohy a předá je do rutiny Disable-ScheduledJob , aby je zakázala.

Naplánovanou úlohu můžete znovu povolit pomocí rutiny Enable-ScheduledJob a pomocí rutiny Start-Job spustit zakázanou naplánovanou úlohu.

Disable-ScheduledJob nevygeneruje upozornění nebo chyby, pokud zakážete naplánovanou úlohu, která je již zakázaná, takže můžete zakázat všechny naplánované úlohy bez podmínek.

Příklad 3: Zakázání vybraných naplánovaných úloh

Tento příklad zakáže naplánovanou úlohu, nezahrnuje přihlašovací údaje.

Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

Úlohy bez přihlašovacích údajů se spouštějí s oprávněním uživatele, který je vytvořil.

Příkaz pomocí rutiny Get-ScheduledJob získá všechny naplánované úlohy v počítači. Operátor kanálu odešle naplánované úlohy do Where-Object rutiny, která vybere naplánované úlohy, které nemají přihlašovací údaje. Příkaz používá operátor not (!) a odkazuje na vlastnost Credential naplánované úlohy. Jiný operátor kanálu odešle vybrané naplánované úlohy do Disable-ScheduledJob rutiny, která je zakáže.

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

Tento příklad zakáže naplánovanou úlohu na dvou vzdálených počítačích.

Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

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

Příklad 5: Zakázání naplánované úlohy podle globálního ID

Tento příklad ukazuje, jak pomocí globálního identifikátoru zakázat naplánovanou úlohu. Hodnota vlastnosti GlobalID naplánované úlohy je jedinečný identifikátor (GUID). Hodnotu GlobalID použijte v případě, že je vyžadována přesnost, například při zakázání plánovaných úloh na více počítačích.

Get-ScheduledJob | Format-Table -Property Name, GlobalID, Command -Autosize

Name             GlobalId                             Command
----             --------                             -------
ArchiveProjects1 a26a0b3d-b4e6-44d3-8b95-8706ef621f7c C:\Scripts\Archive-DxProjects.ps1
Inventory        3ac37e5d-84c0-4a8f-9661-7e88ebb8f914 \\Srv01\Scripts\Get-FullInventory.ps1
Backup-Scripts   4d0cc6be-c082-48d1-baec-1bd8278f3c81  Copy-Item C:\CurrentScripts\*.ps1 -Destination C:\BackupScripts
Test-HelpFiles   d77020ca-f20d-42be-86c8-fc64df97db90 .\Test-HelpFiles.ps1
Test-HelpFiles   2f1606d2-c6cf-4bef-8b1c-ae36a9cc9934 .\Test-DomainHelpFiles.ps1

Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

První příkaz ukazuje jeden ze způsobů, jak najít GlobalID naplánované úlohy. Příkaz pomocí rutiny Get-ScheduledJob získá naplánované úlohy v počítači. Operátor kanálu (|) odešle naplánované úlohy do Format-Table rutiny, která zobrazí vlastnosti Name, GlobalID a Command každé úlohy v tabulce.

Druhý příkaz pomocí rutiny Get-ScheduledJob získá naplánované úlohy v počítači. Operátor kanálu (|) odešle naplánované úlohy do Where-Object rutiny, která vybere naplánovanou úlohu se zadaným globálním ID. Jiný operátor kanálu odešle úlohu do Disable-ScheduledJob rutiny, která ji zakáže.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu 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

Zakáže 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á zakázat. Zadejte proměnnou obsahující objekty ScheduledJobDefinition nebo zadejte příkaz nebo výraz, který získá ScheduledJobDefinition objekty, například Get-ScheduledJob příkaz. Objekt ScheduledJobDefinition lze také nasoučovat do Disable-ScheduledJobobjektu .

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

-Name

Zakáže 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:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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 převést na Disable-ScheduledJob.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

ScheduledJobDefinition

Pokud použijete parametr PassThru , vrátí tato rutina naplánovanou úlohu, která je zakázaná.

Poznámky

  • Disable-ScheduledJob nevygeneruje upozornění nebo chyby, pokud ji použijete k zakázání naplánované úlohy, která je již zakázaná.