Set-SCExternalJob

Модуль:
VirtualMachineManager Module

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

Синтаксис

Progress (по умолчанию) 

Set-SCExternalJob
    [-Job] <Task>
    -ProgressValue <Int32>
    [<CommonParameters>]

Completed 

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

Failed 

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

Описание

Командлет Set-SCExternalJob обновляет существующие внешние задания в диспетчере виртуальных машин (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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Completed
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Failed

Устанавливает состояние внешнего задания как «Сбой».

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Failed
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InfoMessage

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Completed
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Job

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

Свойства параметра

Тип:Task
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ProgressValue

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Progress
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

Task

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