Udostępnij za pośrednictwem


Get-ScheduledJob

Pobiera zaplanowane zadania na komputerze lokalnym.

Składnia

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-ScheduledJob
   [-Name] <String[]>
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-ScheduledJob pobiera zaplanowane zadania na komputerze lokalnym. Get-ScheduledJob pobiera tylko zaplanowane zadania utworzone przez bieżącego użytkownika przy użyciu polecenia cmdlet Register-ScheduledJob.

Mimo że zadania tworzone przy użyciu polecenia cmdlet Register-ScheduledJob są wyświetlane w harmonogramie zadań, get-ScheduledJob pobiera tylko zaplanowane zadania. Nie pobiera zaplanowanych zadań utworzonych w harmonogramie zadań.

Bez parametrów Get-ScheduledJob pobiera wszystkie zaplanowane zadania na komputerze. Możesz użyć parametrów Get-ScheduledJob, aby uzyskać zaplanowane zadania według identyfikatora lub nazwy i zbadać je lub przekazać je do innych poleceń cmdlet.

get-ScheduledJob jest jedną z kolekcji poleceń cmdlet planowania zadań w psScheduledJob modułu, który jest dołączony 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. Pobieranie wszystkich zaplanowanych zadań

PS C:\> Get-ScheduledJob

To polecenie pobiera wszystkie zaplanowane zadania na komputerze lokalnym.

Przykład 2. Pobieranie zaplanowanych zadań według nazwy

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive*

To polecenie pobiera wszystkie zaplanowane zadania na komputerze z nazwami zawierającymi kopie zapasowe lub Archiwum. Ten format polecenia umożliwia wyszukiwanie określonych zadań.

Przykład 3. Pobieranie zaplanowanych zadań na komputerach zdalnych

PS C:\> Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

To polecenie pobiera wszystkie zaplanowane zadania na komputerach wymienionych w pliku Servers.txt. Polecenie używa polecenia cmdlet Invoke-Command do uruchomienia polecenia Get-ScheduleJob na każdym komputerze.

Przykład 4. Potok zaplanowane zadania do innych poleceń cmdlet

PS C:\> Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

To polecenie pobiera wyzwalacze zadań DailyBackup i WeeklyBackup zaplanowanych zadań. Używa on polecenia cmdlet Get-ScheduledJob w celu pobrania zaplanowanych zadań i polecenia cmdlet Get-JobTrigger w celu pobrania wyzwalaczy zadań zaplanowanych.

Parametry

-Id

Pobiera tylko zaplanowane zadania z określonym numerem identyfikacyjnym (id). Wprowadź co najmniej jeden identyfikator zaplanowanych zadań na komputerze. Domyślnie Get-ScheduledJob pobiera wszystkie zaplanowane zadania na komputerze.

Typ:Int32[]
Position:0
Domyślna wartość:All jobs
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Pobiera tylko zaplanowane zadania o określonych nazwach. Wprowadź co najmniej jedną nazwę zaplanowanych zadań na komputerze. Obsługiwane są symbole wieloznaczne. Domyślnie Get-ScheduledJob pobiera wszystkie zaplanowane zadania na komputerze.

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

Dane wejściowe

None

Nie można przekazać danych wejściowych do get-ScheduledJob.

Dane wyjściowe

ScheduledJobDefinition

Uwagi

  • Każde zaplanowane zadanie jest zapisywane w podkatalogu katalogu $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs na komputerze lokalnym. Podkatalog ma nazwę zaplanowanego zadania i zawiera plik XML zaplanowanego zadania i rekordy historii wykonywania. Aby uzyskać więcej informacji na temat zaplanowanych zadań na dysku, zobacz about_Scheduled_Jobs_Advanced.
  • Zaplanowane zadania tworzone w programie Windows PowerShell są wyświetlane w harmonogramie zadań w folderze Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs. Harmonogram zadań umożliwia wyświetlanie i edytowanie zaplanowanego zadania.
  • Możesz użyć harmonogramu zadań, narzędzia wiersza polecenia SchTasks.exe i poleceń cmdlet harmonogramu zadań, aby zarządzać zaplanowanymi zadaniami tworzonymi za pomocą poleceń cmdlet Zaplanowane zadanie. Nie można jednak używać poleceń cmdlet Zaplanowane zadanie do zarządzania zadaniami utworzonymi w harmonogramie zadań.