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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Failed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InfoMessage

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Job

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

Type:Task
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProgressValue

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

Task

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