Udostępnij za pośrednictwem

Enable-ScheduledJob

  • Odwołanie
Moduł:
PSScheduledJob

Włącza zaplanowane zadanie.

Składnia

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

Opis

Polecenie cmdlet Enable-ScheduledJob ponownie włącza zaplanowane zadania wyłączone, takie jak wyłączone za pomocą polecenia cmdlet Disable-ScheduledJob. Włączone zadania są uruchamiane automatycznie po wyzwoleniu.

Aby włączyć zaplanowane zadanie, polecenie cmdlet Enable-ScheduledJob ustawia właściwość Enabled zadania zaplanowanego na $True.

Enabled-ScheduledJob jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob dołączonym do programu 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. Włączanie zaplanowanego zadania

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

To polecenie włącza zaplanowane zadanie o identyfikatorze 2 na komputerze lokalnym. Dane wyjściowe pokazują efekt polecenia .

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

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

To polecenie włącza wszystkie zaplanowane zadania na komputerze lokalnym. Używa on polecenia cmdlet Get-ScheduledJob, aby pobrać wszystkie zaplanowane zadanie i polecenie cmdlet Enable-ScheduledJob, aby je włączyć.

Enable-ScheduledJob nie generuje ostrzeżeń ani błędów w przypadku włączenia zaplanowanego zadania, które jest już włączone, dzięki czemu można włączyć wszystkie zaplanowane zadania bez warunków.

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

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

To polecenie umożliwia zaplanowane zadania, które nie wymagają połączenia sieciowego.

Polecenie używa polecenia cmdlet Get-ScheduledJob, aby pobrać wszystkie zaplanowane zadania na komputerze. Operator potoku wysyła zaplanowane zadania do polecenia cmdlet Get-ScheduledJobOption, które pobiera opcje zadania dla każdego zaplanowanego zadania. Każdy obiekt opcji zadania ma właściwość JobDefinition zawierającą skojarzone zaplanowane zadanie. Właściwość JobDefinition służy do wykonania polecenia .

Polecenie używa operatora potoku (|) do wysyłania opcji zadania do polecenia cmdlet Where-Object, które wybiera obiekty opcji zaplanowanego zadania, w których właściwość RunWithoutNetwork ma wartość True ($true). Inny operator potoku wysyła wybrane obiekty opcji zaplanowanego zadania do polecenia cmdlet ForEach-Object, które uruchamia Enable-ScheduledJob polecenie w zaplanowanym zadaniu w wartości właściwości JobDefinition każdego obiektu opcji zadania.

Przykład 4. Włączanie zaplanowanych zadań na komputerze zdalnym

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

To polecenie umożliwia zaplanowane zadania, które mają "test" w nazwach na dwóch komputerach zdalnych, Srv01 i Srv10.

Polecenie używa polecenia cmdlet Invoke-Command do uruchomienia Enable-ScheduledJob polecenia na komputerach Srv01 i Srv10. Polecenie używa parametru NameEnable-ScheduledJob w celu włączenia zaplanowanego zadania spisu na każdym komputerze.

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

Włą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 włączenia. Wprowadź zmienną zawierającą obiekty ScheduledJobDefinition lub wpisz polecenie lub wyrażenie, które pobiera ScheduledJobDefinition obiektów, takich jak Get-ScheduledJob polecenia. Możesz również przekazać obiekt ScheduledJobDefinition do enable-ScheduledJob.

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

-Name

Włą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ść:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

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 przekazać potokiem, aby Enable-ScheduledJob.

Dane wyjściowe

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Jeśli używasz parametru Passthru, Enable-ScheduledJob zwraca zaplanowane zadanie, które zostało włączone. W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Uwagi

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