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

Set-SCExternalJob

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

Обновляет существующее внешнее задание.

Синтаксис

Set-SCExternalJob
   [-Job] <Task>
   -ProgressValue <Int32>
   [<CommonParameters>]
Set-SCExternalJob
   [-Job] <Task>
   [-Completed]
   [-InfoMessage <String>]
   [<CommonParameters>]
Set-SCExternalJob
   [-Job] <Task>
   [-Failed]
   -InfoMessage <String>
   [<CommonParameters>]

Описание

Командлет Set-SCExternalJob обновляет существующие внешние задания в Virtual Machine Manager (VMM). Вы можете обновить процент завершения задания или задать состояние задания на завершение или сбой.

Дополнительные сведения о внешних заданиях см. в командлете New-SCExternalJob.

Примеры

Пример 1. Задание внешнего задания на 15% завершено

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob01"
PS C:\> Set-SCExternalJob -Job $ExternalJob -ProgressValue 15

Первая команда получает объект внешнего задания с именем ExternalJob01 и сохраняет объект в переменной $ExternalJob.

Вторая команда задает значение хода выполнения задания, хранящегося в $ExternalJob 15.

Пример 2. Задание внешнего задания завершено

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob02"
PS C:\> Set-SCExternalJob -Job $ExternalJob -Completed -InfoMessage "Some information about the completed job"

Первая команда получает объект внешнего задания с именем ExternalJob02 и сохраняет объект в переменной $ExternalJob.

Вторая команда задает состояние задания, хранящегося в $ExternalJob, для завершения и добавляет сведения о задании.

Пример 3. Установка внешнего задания на сбой

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob03"
PS C:\> Set-SCExternalJob -Job $ExternalJob -Failed -InfoMessage "An error message for the failed job"

Первая команда получает объект внешнего задания с именем ExternalJob03 и сохраняет объект в переменной $ExternalJob.

Вторая команда задает состояние задания, хранящегося в $ExternalJob, не удалось, и добавляет сведения о задании.

Параметры

-Completed

Задает состояние внешнего задания для завершения.

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

-Failed

Задает состояние внешнего задания, в котором произошел сбой.

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

-InfoMessage

Предоставляет информационное сообщение для внешних заданий.

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

-Job

Указывает объект задания VMM.

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

-ProgressValue

Предоставляет процент выполнения внешнего задания.

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

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

Task

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