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.

Pokud chcete zakázat naplánovanou úlohu, nastaví rutina Disable-ScheduledJob vlastnost Enabled naplánované úlohy na False ($false). Pokud chcete naplánovanou úlohu znovu povolit, použijte rutinu Enable-ScheduledJob.

Disable-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: Zakázání naplánované úlohy

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

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

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

PS C:\> 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

Tento příkaz zakáže 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 Disable-ScheduledJob k jejich zakázání.

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

zakázat naplánovanou úlohu negeneruje 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

PS C:\> Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

Tento příkaz zakáže naplánovanou úlohu, nezahrnuje přihlašovací údaje. Úlohy bez přihlašovacích údajů se spouštějí s oprávněním uživatele, který je vytvořil.

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 Where-Object, 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 rutiny Disable-ScheduledJob, která je zakáže.

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

PS C:\> Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

Tento příkaz zakáže naplánovanou úlohu TestJob na dvou vzdálených počítačích, Srv01 a Srv10.

Příkaz používá rutinu Invoke-Command ke spuštění příkazu Disable-ScheduledJob na počítačích Srv01 a Srv10. Příkaz používá parametr název Disable-ScheduledJob k výběru naplánované úlohy TestJob na každém počítači.

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

The first command demonstrates one way of finding the GlobalID of a scheduled job. The command uses the Get-ScheduledJob cmdlet to get the scheduled jobs on the computer. A pipeline operator (|) sends the scheduled jobs to the Format-Table cmdlet, which displays the Name, GlobalID, and Command properties of each job in a table.
PS C:\> 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

The second command uses the  Get-ScheduledJob cmdlet to get the scheduled jobs on the computer. A pipeline operator (|) sends the scheduled jobs to the Where-Object cmdlet, which selects the scheduled job with the specified global ID. Another pipeline operator sends the job to the **Disable-ScheduledJob** cmdlet, which disables it.
PS C:\> Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

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.

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

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, 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é Disable-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

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: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 řadit tak, aby disable-ScheduledJob.

Výstupy

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Pokud použijete parametr Passthru, Disable-ScheduledJob vrátí naplánovanou úlohu, která byla zakázaná. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • Zakázat naplánovanou úlohu nevygeneruje upozornění nebo chyby, pokud ji použijete k zakázání naplánované úlohy, která je již zakázaná.