Поделиться через


Get-ScheduledJob

Получает запланированные задания на локальном компьютере.

Синтаксис

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

Описание

Командлет Get-ScheduledJob получает запланированные задания на локальном компьютере. Get-ScheduledJob получает только запланированные задания, созданные текущим пользователем с помощью командлета Register-ScheduledJob .

Хотя задания, созданные с помощью командлета Register-ScheduledJob , отображаются в планировщике задач, Get-ScheduledJob получает только запланированные задания. Он не возвращает запланированные задачи, созданные в планировщике.

Без параметров Get-ScheduledJob получает все запланированные задания на компьютере. Параметры можно использовать для получения запланированных заданий по идентификатору Get-ScheduledJob или имени, а также для их проверки или передачи другим командлетам.

Get-ScheduledJob — одна из коллекций командлетов планирования заданий в модуле PSScheduledJob , включенном в Windows PowerShell.

Дополнительные сведения о запланированных заданиях см. в разделах описания в модуле PSScheduledJob. Импортируйте модуль PSScheduledJob, а затем введите Get-Help about_Scheduled* или просмотрите about_Scheduled_Jobs.

Этот командлет впервые появился в Windows PowerShell 3.0.

Примеры

Пример 1. Получение всех запланированных заданий

Этот пример получает все запланированные задания на локальном компьютере.

Get-ScheduledJob

Пример 2. Получение запланированных заданий по имени

Этот пример получает все запланированные задания на компьютере с именами, включающими резервное копирование или архив. Формат этой команды позволяет искать определенные задания.

Get-ScheduledJob -Name *Backup*, *Archive*

Пример 3. Получение запланированных заданий на удаленных компьютерах

Этот пример получает все запланированные задания на компьютерах, перечисленных в текстовом файле.

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Команда использует Invoke-Command командлет для выполнения Get-ScheduleJob команды на каждом компьютере.

Пример 4. Передача запланированных заданий другим командлетам

Этот пример получает триггеры заданий указанных запланированных заданий.

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Он использует Get-ScheduledJob командлет для получения запланированных заданий и их отправки Get-JobTrigger командлету для получения триггеров заданий, запланированных.

Параметры

-Id

Возвращает только запланированные задания с указанным идентификационным номером (идентификатором). Введите один или несколько идентификаторов запланированных заданий на компьютере. По умолчанию Get-ScheduledJob получает все запланированные задания на компьютере.

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

-Name

Возвращает только запланированные задания с указанными именами. Введите одно или несколько имен запланированных заданий на компьютере. Поддерживаются подстановочные знаки. По умолчанию Get-ScheduledJob получает все запланированные задания на компьютере.

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

Входные данные

None

Объекты можно передать в этот командлет.

Выходные данные

ScheduledJobDefinition

Этот командлет возвращает определение запланированного задания.

Примечания

  • Каждое запланированное задание сохраняется в подкаталоге $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs каталога на локальном компьютере. Этот подкаталог назван по имени запланированного задания и содержит XML-файл для этого задания и записи его журнала выполнения. Дополнительные сведения о запланированных заданиях на диске см. в about_Scheduled_Jobs_Advanced.
  • Запланированные задания, создаваемые в Windows PowerShell, отображаются в планировщике задач в папке планировщика Library\Microsoft\Windows\PowerShell\ScheduledJobs задач. Планировщик заданий можно использовать для просмотра и изменения запланированного задания.
  • Вы можете использовать планировщик задач, SchTasks.exe средство командной строки и командлеты планировщика задач для управления запланированными заданиями, создаваемыми с помощью командлетов запланированных заданий. Однако нельзя использовать командлеты запланированных заданий для управления задачами, созданными в планировщике заданий.