Udostępnij za pośrednictwem

Disable-ScheduledJob

  • Odwołanie
Moduł:
PSScheduledJob

Wyłącza zaplanowane zadanie.

Składnia

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

Opis

Polecenie Disable-ScheduledJob cmdlet tymczasowo wyłącza zaplanowane zadania. Wyłączenie powoduje zachowanie wszystkich właściwości zadania i nie powoduje wyłączenia wyzwalaczy zadania, ale uniemożliwia automatyczne uruchamianie zaplanowanych zadań po wyzwoleniu. Możesz uruchomić wyłączone zaplanowane zadanie przy użyciu Start-Job polecenia cmdlet lub użyć wyłączonego zaplanowanego zadania jako szablonu.

Aby wyłączyć zaplanowane zadanie, Disable-ScheduledJob polecenie cmdlet ustawia właściwość Enabled zaplanowanego zadania na False. Aby ponownie włączyć zaplanowane zadanie, użyj Enable-ScheduledJob polecenia cmdlet .

Disable-ScheduledJob jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob , który znajduje się w programie Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w programie Windows PowerShell 3.0.

Przykłady

Przykład 1. Wyłączanie zaplanowanego zadania

Ten przykład wyłącza zaplanowane zadanie na komputerze lokalnym.

Disable-ScheduledJob -ID 2 -PassThru

To polecenie wyłącza zaplanowane zadanie o identyfikatorze 2 na komputerze lokalnym.

Przykład 2. Wyłączanie wszystkich zaplanowanych zadań

Ten przykład wyłącza wszystkie zaplanowane zadania na komputerze lokalnym.

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

Polecenie Get-ScheduledJob cmdlet umożliwiające pobranie wszystkich zaplanowanych zadań i potokuje je do Disable-ScheduledJob polecenia cmdlet w celu ich wyłączenia.

Zaplanowane zadanie można ponownie włączyć przy użyciu Enable-ScheduledJob polecenia cmdlet i uruchomić wyłączone zaplanowane zadanie za pomocą Start-Job polecenia cmdlet .

Disable-ScheduledJob program nie generuje ostrzeżeń ani błędów, jeśli wyłączysz zaplanowane zadanie, które jest już wyłączone, dzięki czemu można wyłączyć wszystkie zaplanowane zadania bez warunków.

Przykład 3. Wyłączanie wybranych zaplanowanych zadań

Ten przykład wyłącza zaplanowane zadanie nie uwzględnia poświadczeń.

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

Zadania bez poświadczeń są uruchamiane z uprawnieniem użytkownika, który je utworzył.

Polecenie używa Get-ScheduledJob polecenia cmdlet , aby pobrać wszystkie zaplanowane zadania na komputerze. Operator potoku wysyła zaplanowane zadania do Where-Object polecenia cmdlet, które wybiera zaplanowane zadania, które nie mają poświadczeń. Polecenie używa operatora not (!) i odwołuje się do właściwości Credential zaplanowanego zadania. Inny operator potoku wysyła wybrane zaplanowane zadania do Disable-ScheduledJob polecenia cmdlet, co powoduje ich wyłączenie.

Przykład 4: Wyłączanie zaplanowanych zadań na komputerze zdalnym

Ten przykład wyłącza zaplanowane zadanie na dwóch komputerach zdalnych.

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

Polecenie używa Invoke-Command polecenia cmdlet do uruchamiania Disable-ScheduledJob polecenia na komputerach Srv01 i Srv10. Polecenie używa parametru Name polecenia Disable-ScheduledJob , aby wybrać zaplanowane zadanie TestJob na każdym komputerze.

Przykład 5. Wyłączanie zaplanowanego zadania według identyfikatora globalnego

W tych przykładach pokazano, jak wyłączyć zaplanowane zadanie przy użyciu jego identyfikatora globalnego. Wartość właściwości GlobalID zaplanowanego zadania jest unikatowym identyfikatorem (GUID). Użyj wartości GlobalID, jeśli jest wymagana precyzja, na przykład podczas wyłączania zaplanowanych zadań na wielu komputerach.

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

Pierwsze polecenie demonstruje jeden ze sposobów znajdowania identyfikatora GlobalID zaplanowanego zadania. Polecenie używa Get-ScheduledJob polecenia cmdlet do pobrania zaplanowanych zadań na komputerze. Operator potoku (|) wysyła zaplanowane zadania do Format-Table polecenia cmdlet, które wyświetla właściwości Name, GlobalID i Command każdego zadania w tabeli.

Drugie polecenie używa Get-ScheduledJob polecenia cmdlet do pobrania zaplanowanych zadań na komputerze. Operator potoku (|) wysyła zaplanowane zadania do Where-Object polecenia cmdlet, które wybiera zaplanowane zadanie z określonym identyfikatorem globalnym. Inny operator potoku wysyła zadanie do Disable-ScheduledJob polecenia cmdlet, co powoduje jego wyłączenie.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Wyłącza zaplanowane zadanie z określonym numerem identyfikacyjnym (ID). Wprowadź identyfikator zaplanowanego zadania.

Typ:Int32
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Określa zaplanowane zadanie do wyłączenia. Wprowadź zmienną zawierającą obiekty ScheduledJobDefinition lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJobDefinition, takie jak Get-ScheduledJob polecenie. Możesz również przekazać obiekt ScheduledJobDefinition do Disable-ScheduledJobobiektu .

Typ:ScheduledJobDefinition
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Wyłącza zaplanowane zadania z określonymi nazwami. Wprowadź nazwę zaplanowanego zadania. Obsługiwane są symbole wieloznaczne.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ScheduledJobDefinition

Zaplanowane zadanie można potokować do Disable-ScheduledJob.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

ScheduledJobDefinition

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca zaplanowane zadanie, które jest wyłączone.

Uwagi

  • Disable-ScheduledJob program nie generuje ostrzeżeń ani błędów, jeśli używasz go do wyłączenia zaplanowanego zadania, które jest już wyłączone.