Disable-ScheduledJob

  • Referencia
Modul:
PSScheduledJob

Letilt egy ütemezett feladatot.

Syntax

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

A Disable-ScheduledJob parancsmag ideiglenesen letiltja az ütemezett feladatokat. A letiltás megőrzi az összes feladattulajdonságt, és nem tiltja le a feladat-eseményindítókat, de megakadályozza, hogy az ütemezett feladatok automatikusan elindulnak aktiváláskor. A letiltott ütemezett feladatokat elindíthatja a Start-Job parancsmaggal, vagy használhat egy letiltott ütemezett feladatot sablonként.

Ütemezett feladat letiltásához a Disable-ScheduledJob parancsmag hamis értékre állítja az ütemezett feladat Engedélyezett tulajdonságát. Az ütemezett feladat ismételt engedélyezéséhez használja a Enable-ScheduledJob parancsmagot.

Disable-ScheduledJoba Windows PowerShellben található PSScheduledJob modul feladatütemezési parancsmagjainak egyik gyűjteménye.

Az ütemezett feladatokról további információt a PSScheduledJob modul Témakörök című témakörében talál. Importálja a PSScheduledJob modult, majd írja be a következőt: Get-Help about_Scheduled* vagy tekintse meg a about_Scheduled_Jobs.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Ütemezett feladat letiltása

Ez a példa letilt egy ütemezett feladatot a helyi számítógépen.

Disable-ScheduledJob -ID 2 -Passthru

Ez a parancs letiltja a helyi számítógépen a 2. azonosítójú ütemezett feladatot.

2. példa: Az összes ütemezett feladat letiltása

Ez a példa letiltja a helyi számítógépen lévő összes ütemezett feladatot.

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

A Get-ScheduledJob parancsmag lekéri az összes ütemezett feladatot, és leküldi őket a Disable-ScheduledJob parancsmagba, hogy letiltsa őket.

Az ütemezett feladatokat újra engedélyezheti a Enable-ScheduledJob parancsmag használatával, és futtathat egy letiltott ütemezett feladatot a Start-Job parancsmag használatával.

Disable-ScheduledJob nem generál figyelmeztetéseket vagy hibákat, ha letilt egy olyan ütemezett feladatot, amely már le van tiltva, így feltételek nélkül letilthatja az összes ütemezett feladatot.

3. példa: A kijelölt ütemezett feladatok letiltása

Ez a példa letiltja az ütemezett feladatot, és nem tartalmaz hitelesítő adatokat.

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

A hitelesítő adatok nélküli feladatok az őket létrehozó felhasználó engedélyével futnak.

A parancs a Get-ScheduledJob parancsmaggal lekéri az összes ütemezett feladatot a számítógépen. A folyamatüzemeltető elküldi az ütemezett feladatokat a Where-Object parancsmagnak, amely olyan ütemezett feladatokat választ ki, amelyek nem rendelkeznek hitelesítő adatokkal. A parancs a nem (!) operátort használja, és az ütemezett feladat Hitelesítőadat tulajdonságára hivatkozik. Egy másik folyamatkezelő elküldi a kijelölt ütemezett feladatokat a Disable-ScheduledJob parancsmagnak, amely letiltja őket.

4. példa: Ütemezett feladatok letiltása távoli számítógépen

Ez a példa letilt egy ütemezett feladatot két távoli számítógépen.

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

A parancs a Invoke-Command parancsmaggal futtat egy Disable-ScheduledJob parancsot az Srv01 és az Srv10 számítógépeken. A parancs a Név paraméter használatával Disable-ScheduledJob választja ki az egyes számítógépeken a TestJob ütemezett feladatát.

5. példa: Ütemezett feladatok letiltása a globális azonosító alapján

Ez a példa bemutatja, hogyan tilthat le egy ütemezett feladatot a globális azonosítójával. Az ütemezett feladatok GlobalID tulajdonságának értéke egyedi azonosító (GUID). A GlobalID értéket akkor használja, ha pontosságra van szükség, például ha több számítógépen letiltja az ütemezett feladatokat.

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

Az első parancs bemutatja az ütemezett feladatok GlobalID-azonosítójának megkeresésének egyik módját. A parancs a Get-ScheduledJob parancsmaggal szerzi be az ütemezett feladatokat a számítógépen. A folyamatüzemeltető (|) elküldi az ütemezett feladatokat a Format-Table parancsmagnak, amely megjeleníti a tábla egyes feladatainak nevét, GlobalID- és parancstulajdonságait.

A második parancs a Get-ScheduledJob parancsmaggal szerzi be az ütemezett feladatokat a számítógépen. A folyamatkezelő (|) elküldi az ütemezett feladatokat a Where-Object parancsmagnak, amely kiválasztja az ütemezett feladatot a megadott globális azonosítóval. Egy másik folyamatkezelő elküldi a feladatot a Disable-ScheduledJob parancsmagnak, amely letiltja azt.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Letiltja az ütemezett feladatot a megadott azonosítószámmal (azonosítóval). Adja meg egy ütemezett feladat azonosítóját.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Megadja a letiltani kívánt ütemezett feladatot. Adjon meg egy változót, amely ScheduledJobDefinition objektumokat tartalmaz, vagy írjon be egy parancsot vagy kifejezést, amely beolvas egy ScheduledJobDefinition objektumot, például egy parancsotGet-ScheduledJob. ScheduledJobDefinition objektumot is becsúszthat a programbaDisable-ScheduledJob.

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Letiltja az ütemezett feladatokat a megadott névvel. Adja meg egy ütemezett feladat nevét. A helyettesítő karakterek támogatottak.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

ScheduledJobDefinition

Az ütemezett feladatokat becsúszthatja a következőre Disable-ScheduledJob: .

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

ScheduledJobDefinition

A PassThru paraméter használatakor ez a parancsmag a letiltott ütemezett feladatot adja vissza.

Jegyzetek

  • Disable-ScheduledJob nem generál figyelmeztetéseket vagy hibákat, ha egy már letiltott ütemezett feladat letiltására használja.