about_Scheduled_Jobs_Advanced
Краткое описание
Дополнительные разделы о запланированных заданиях, включая описание структуры файлов, лежащей в основе запланированных заданий.
Подробное описание
Дополнительные сведения о командлетах, содержащихся в модуле PSScheduledJob , см. в разделе PSScheduledJob.
Каталоги и файлы запланированных заданий
Запланированные задания PowerShell — это задания PowerShell и задачи планировщика задач. Каждое запланированное задание регистрируется в планировщике задач и сохраняется на диске в формате XML сериализации Microsoft платформа .NET Framework.
При создании запланированного задания PowerShell создает каталог для запланированного задания в каталоге $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs на локальном компьютере. Имя каталога совпадает с именем задания.
Ниже приведен пример каталога ScheduledJobs .
Get-ChildItem $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs
Directory: C:\Users\User01\AppData\Local
\Microsoft\Windows\PowerShell\ScheduledJobs
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 9/29/2011 10:03 AM ArchiveProjects
d---- 9/30/2011 1:18 PM Inventory
d---- 10/20/2011 9:15 AM Backup-Scripts
d---- 11/7/2011 10:40 AM ProcessJob
d---- 11/2/2011 10:25 AM SecureJob
d---- 9/27/2011 1:29 PM Test-HelpFiles
d---- 9/26/2011 4:22 PM DeployPackage
Каждое запланированное задание имеет собственный каталог. Каталог содержит XML-файл запланированного задания и подкаталог вывода .
$Path = "$HOME\AppData\Local\Microsoft\Windows\PowerShell"
$Path += "\ScheduledJobs\ProcessJob"
Get-ChildItem $Path
Directory: C:\Users\User01\AppData\Local\Microsoft\Windows\PowerShell
\ScheduledJobs\ProcessJob
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 11/1/2011 3:00 PM Output
-a--- 11/1/2011 3:43 PM 7281 ScheduledJobDefinition.xml
Каталог выходных данных для запланированного задания содержит журнал выполнения. Каждый раз, когда триггер задания запускает запланированное задание, PowerShell создает каталог с именем timestamp в выходном каталоге. Каталог меток времени содержит результаты задания в файле Results.xml и состоянии задания в файле Status.xml.
Следующая команда показывает каталоги журнала выполнения для запланированного задания ProcessJob .
$Path = "$HOME\AppData\Local\Microsoft"
$Path += "\Windows\PowerShell\ScheduledJobs\ProcessJob\Output"
Get-ChildItem $Path
Directory: C:\Users\User01\AppData\Local\Microsoft
\Windows\PowerShell\ScheduledJobs\ProcessJob\Output
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 11/2/2011 3:00 AM 20111102-030002-260
d---- 11/3/2011 3:00 AM 20111103-030002-277
d---- 11/4/2011 3:00 AM 20111104-030002-209
d---- 11/5/2011 3:00 AM 20111105-030002-251
d---- 11/6/2011 3:00 AM 20111106-030002-174
d---- 11/7/2011 12:00 AM 20111107-000001-914
d---- 11/7/2011 3:00 AM 20111107-030002-376
$Path = "$HOME\AppData\Local\Microsoft\Windows\PowerShell\"
$Path += "ScheduledJobs\ProcessJob\Output\20111102-030002-260"
Get-ChildItem $Path
Directory: C:\Users\User01\AppData\Local\Microsoft\Windows\PowerShell
\ScheduledJobs\ProcessJob\Output\20111102-030002-260
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 11/2/2011 3:00 AM 581106 Results.xml
-a--- 11/2/2011 3:00 AM 9451 Status.xml
Вы можете открыть и проверить ScheduledJobDefinition.xml, Results.xml и Status.xml файлы или использовать Select-XML командлет для анализа файлов.
Предупреждение
Не изменяйте XML-файлы. Если любой XML-файл содержит недопустимый XML- файл, PowerShell удаляет запланированное задание и его журнал выполнения, включая результаты задания.
Немедленное запуск запланированного задания
Вы можете сразу запустить запланированное задание одним из двух способов:
- Запустите командлет, чтобы запустить любое запланированное
Start-Jobзадание. - Добавьте параметр RunNow в
Register-ScheduledJobкоманду, чтобы запустить задание сразу после выполнения команды.
Задания, запущенные с помощью командлета Start-Job , являются стандартными фоновыми заданиями PowerShell, а не экземплярами запланированного задания. Как и все фоновые задания, эти задания запускаются немедленно, они не подвергаются параметрам задания или влияют на триггеры заданий. Выходные данные задания не сохраняются в каталоге выходных данных запланированного каталога заданий.
Следующая команда использует параметр DefinitionName командлета Start-Job для запуска запланированного задания ProcessJob.
Start-Job -DefinitionName ProcessJob
Чтобы управлять заданием и получать результаты задания, используйте командлеты заданий. Дополнительные сведения о командлетах заданий см. в about_Jobs.
Примечание.
Чтобы использовать командлеты задания для экземпляров запланированных заданий, модуль PSScheduledJob должен быть импортирован в сеанс. Чтобы импортировать модуль PSScheduledJob , введите Import-Module PSScheduledJob или используйте любой командлет запланированного задания, например Get-ScheduledJob.
Переименование запланированного задания
Чтобы переименовать запланированное задание, используйте параметр Name командлета Set-ScheduledJob . При переименовании запланированного задания PowerShell изменяет имя запланированного задания и каталог запланированных заданий. Однако он не изменяет имена экземпляров запланированного задания, уже запущенного.
Получение времени начала и окончания
Чтобы получить даты и время начала и окончания экземпляров задания, используйте свойства PSBeginTime и PSEndTime объекта ScheduledJob, возвращающего Get-Job запланированные задания.
В следующем примере используется параметр Property командлета Format-Table для отображения свойств PSBeginTime и PSEndTime каждого экземпляра задания в таблице. Вычисляемое свойство с именем Label отображает истекшее время каждого экземпляра задания.
Get-job -Name UpdateHelpJob |
Format-Table -Property ID, PSBeginTime, PSEndTime,
@{Label="Elapsed Time";Expression={$.PsEndTime - $.PSBeginTime}}
Id PSBeginTime PSEndTime Elapsed Time
-- ----------- --------- ------------
2 11/3/2011 3:00:01 AM 11/3/2011 3:00:39 AM 00:00:38.0053854
3 11/4/2011 3:00:02 AM 11/4/2011 3:01:01 AM 00:00:59.1188475
4 11/5/2011 3:00:02 AM 11/5/2011 3:00:50 AM 00:00:48.3692034
5 11/6/2011 3:00:01 AM 11/6/2011 3:00:54 AM 00:00:52.8013036
6 11/7/2011 3:00:01 AM 11/7/2011 3:00:38 AM 00:00:37.1930350
7 11/8/2011 3:00:01 AM 11/8/2011 3:00:57 AM 00:00:56.2570556
8 11/9/2011 3:00:03 AM 11/9/2011 3:00:55 AM 00:00:51.8142222
9 11/10/2011 3:00:02 AM 11/10/2011 3:00:42 AM 00:00:40.7195954
Управление журналом выполнения
Вы можете определить количество результатов экземпляра задания, сохраненных для каждого запланированного задания, и удалить журнал выполнения и сохраненные результаты задания любого запланированного задания.
Свойство ExecutionHistoryLength запланированного задания определяет, сколько результатов экземпляра задания сохраняется для запланированного задания. Если число сохраненных результатов превышает значение свойства ExecutionHistoryLength , PowerShell удаляет результаты самого старого экземпляра, чтобы освободить место для результатов последнего экземпляра.
По умолчанию PowerShell сохраняет журнал выполнения и результаты 32 экземпляров каждого запланированного задания. Чтобы изменить это значение, используйте параметры MaxResultCount для Register-ScheduledJob командлетов или Set-ScheduledJob командлетов.
Чтобы удалить журнал выполнения и все результаты запланированного задания, используйте параметр ClearExecutionHistory командлета Set-ScheduledJob . Удаление этого журнала выполнения не предотвращает сохранение результатов запланированных заданий в PowerShell.
В следующем примере используется splatting для создания $JobParms значений параметров, передаваемых командлету Register-ScheduledJob . Дополнительные сведения см. в разделе about_Splatting.md.
Используется Register-ScheduledJob@JobParms для создания запланированного задания. Команда использует параметр MaxResultCount со значением 12, чтобы сохранить только 12 новых результатов экземпляра задания.
$JobParms = @{
Name = "ProcessJob"
ScriptBlock = {Get-Process}
MaxResultCount = "12"
}
Register-ScheduledJob @JobParms
Следующая команда использует параметр MaxResultCount командлета Set-ScheduledJob для увеличения числа сохраненных результатов экземпляра до 15.
Get-ScheduledJob ProcessJob | Set-ScheduledJob -MaxResultCount 15
Следующая команда удаляет журнал выполнения и текущие сохраненные результаты запланированного задания ProcessJob .
Get-ScheduledJob ProcessJob | Set-ScheduledJob -ClearExecutionHistory
Следующая команда получает значения свойств name и ExecutionHistoryLength всех запланированных заданий на компьютере и отображает их в таблице.
Get-ScheduledJob |
Format-Table -Property Name, ExecutionHistoryLength -AutoSize
См. также
PowerShell
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по