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

Get-ScheduledJobOption

  • Ссылка
Модуль:
PSScheduledJob

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

Синтаксис

Get-ScheduledJobOption
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Id] <Int32>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Name] <String>
   [<CommonParameters>]

Описание

Командлет Get-ScheduledJobOption получает параметры задания запланированных заданий. Эта команда используется для проверки параметров задания или их передачи в другие командлеты.

Параметры задания не сохраняются на диск независимо; они являются частью запланированного задания. Чтобы получить параметры запланированного задания, укажите это запланированное задание.

Используйте параметры командлета для идентификации запланированного Get-ScheduledJobOption задания. Вы можете определить запланированные задания по именам или идентификаторам, а также путем ввода или отправки объектов ScheduledJob , например возвращаемых командлетом Get-ScheduledJob Get-ScheduledJobOption.

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

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

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

Примеры

Пример 1. Получение параметров задания

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

Get-ScheduledJobOption -Name "*Backup*"

Пример 2. Получение всех параметров задания

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

Get-ScheduledJob | Get-ScheduledJobOption

В примере используется Get-ScheduledJob командлет для получения запланированных заданий на локальном компьютере. Оператор конвейера (|) отправляет запланированные задания командлету Get-ScheduledJobOption , который получает параметры задания каждого запланированного задания.

Пример 3. Получение выбранных параметров задания

В этом примере показано, как найти объект параметров задания с определенными значениями.

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} |
    ForEach-Object {$_.JobDefinition}

Первая команда получает параметры задания, в которых свойство RunElevated имеет значение $True, а свойство RunWithoutNetwork имеет значение $false. В выходных данных показан выбранный объект JobOptions .

Вторая команда показывает, как найти запланированное задание, к которому относятся параметры задания. Эта команда использует оператор конвейера (|) для отправки выбранных параметров задания командлету, который получает свойство JobDefinition каждого объекта параметровForEach-Object. Свойство JobDefinition содержит исходный объект задания.

Пример 4. Использование параметров задания для создания нового задания

В этом примере показано, как использовать параметры задания, Get-ScheduledJobOption которые получают в новом запланированном задании.

$Opts = Get-ScheduledJobOption -Name "BackupTestLogs"
Register-ScheduledJob -Name "Archive-Scripts" -FilePath "\\Srv01\Scripts\ArchiveScripts.ps1" -ScheduledJobOption $Opts

Первая команда используется Get-ScheduledJobOption для получения параметров заданий запланированного задания BackupTestLogs. Команда сохраняет параметры в переменной $Opts .

Вторая команда использует Register-ScheduledJob командлет для создания нового запланированного задания. Значение параметра ScheduledJobOption — объект options в переменной $Opts .

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

$O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

Эта команда использует Invoke-Command командлет для получения параметров запланированного задания задания DataDemon на компьютере Srv01. Команда сохраняет параметры в переменной $O .

Параметры

-Id

Задает идентификационный номер запланированного задания. Get-ScheduledJobOption получает параметры задания указанного запланированного задания.

Чтобы получить идентификационные номера запланированных заданий на локальном компьютере или удаленном компьютере, используйте Get-ScheduledJob командлет.

Тип:Int32
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Указывает запланированное задание. Введите переменную, содержащую объект ScheduledJob или введите команду или выражение, которое получает объект ScheduledJob, например Get-ScheduledJob команду. Можно также передать объект Get-ScheduledJobOptionScheduledJob в .

Тип:ScheduledJobDefinition
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Чтобы получить имена запланированных заданий на локальном компьютере или удаленном компьютере, используйте Get-ScheduledJob командлет.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

ScheduledJobDefinition

Вы можете передать объект запланированного задания в этот командлет.

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

ScheduledJobOptions

Этот командлет возвращает объект ScheduledJobOptions .