Справочник по действиям рабочего процесса средства разработки Service Manager
Важно!
Поддержка этой версии Service Manager завершена. Мы рекомендуем выполнить обновление до Service Manager 2022.
В этой статье содержатся рекомендации для ит-разработчиков, чтобы они могли создавать настраиваемые действия Windows Workflow Foundation (WF), которые ИТ-специалисты могут использовать для создания рабочих процессов WF, относящихся к их ИТ-процессам. Настраиваемые действия WF расширяют библиотеку действий — действия, распространяемые с помощью средства разработки Service Manager. Раздел "Справка по действиям рабочих процессов" данного документа содержит сведения о действиях WF, присутствующих в библиотеке действий по умолчанию. Эти сведения должны помочь разработчикам (или ИТ-специалистам, выступающим в роли разработчиков) при необходимости создать настраиваемые действия WF.
Сведения об использовании действий WF и рабочих процессов WF с Service Manager см. в статье Автоматизация ИТ-процессов с помощью рабочих процессов.
Действия Active Directory
Используйте действия доменные службы Active Directory (AD DS), чтобы сделать функции Active Directory частью рабочего процесса в Service Manager.
Средство разработки Service Manager предоставляет два действия Service Manager по умолчанию в группе Действия Active Directory на панели элементов действий. Эти действия описаны в разделах этой статьи.
Добавление компьютера AD DS в действие группы
Это действие добавляет компьютер в группу безопасности в доменные службы Active Directory (AD DS) в Service Manager. Компьютер и группа должны принадлежать к одному домену, и поиск выполняется во всех контейнерах в домене.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | При использовании этого действия убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в AD DS. |
Свойства
Действие Добавить компьютер AD DS в группу использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Домен компьютера | ComputerDomain | Строка | Да | Полное доменное имя DNS, в котором находится компьютер (например, contoso.com). |
Имя компьютера | FullyQualifiedComputerName | Строка | Да | Имя компьютера. |
Имя группы | FullyQualifiedGroupName | Строка | Да | Имя группы доменных служб Active Directory. |
Действие Добавить компьютер AD DS в группу создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Описание |
---|---|---|---|
Выходные данные | Выходные данные | Логическое | Результат операции: True , если сложение выполнено успешно; False , если произошел сбой. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | None | None |
Добавление пользователя AD DS в действие группы
Это действие добавляет пользователя в группу безопасности в доменные службы Active Directory (AD DS) в Service Manager. Пользователь и группа должны принадлежать к одному и тому же домену. Поиск выполняется во всех контейнерах домена.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | При использовании этого действия убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в AD DS. |
Свойства
Действие Добавить пользователя AD DS в группу использует входные свойства, перечисленные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Домен пользователя | UserDomain | Строка | Да | Полное доменное имя (FQDN) пользователя. |
Имя пользователя | UserName | Строка | Да | Имя входа пользователя. |
Имя группы | FullyQualifiedGroupName | Строка | Да | Полное доменное имя группы. |
Действие Добавить пользователя AD DS в группу создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Описание |
---|---|---|---|
Выходные данные | Выходные данные | Логическое | Результат операции: True , если сложение выполнено успешно, false , если не удалось. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | None | None |
Действия потока управления
Используйте действия потока управления для предоставления структуры (ветвей, циклов или задержек таймера) для рабочего процесса в Service Manager.
Средство разработки предоставляет четыре действия потока управления по умолчанию в группе Поток управления на панели элементов действий .
Отложенное действие
Это действие вызывает задержку между действиями в рабочем процессе в Service Manager. Действие Delay является производным от класса Microsoft платформа .NET Framework DelayActivity.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие Delay использует входные свойства, перечисленные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Initialize TimeoutDuration | InitializeTimeoutDuration | Внутренние | Задает обработчик для инициализации свойства TimeoutDuration . | |
TimeoutDuration | TimeoutDuration | Временной диапазон | Да | Длительность задержки. |
Действие Delay не создает выходное свойство.
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | Дополнительные сведения об этом действии см. в разделе Класс DelayActivity в библиотеке классов платформа .NET Framework. | None |
Действие for Each Loop
Действие For Each Loop принимает в качестве входных данных массив (коллекцию) объектов и повторяет набор действий в цикле для каждого объекта в коллекции. Например, если входная коллекция содержит пять объектов, выполняются пять итераций цикла. Если коллекция пуста, цикл не выполняет итерацию. Верхний предел для количества объектов в коллекции отсутствует. Действие Цикла For Each всегда выполняется на компьютере, на котором выполняется рабочий процесс.
Действие Цикла For Each — это составное действие с двумя контейнерами для действий:
Контейнер входных данных. Это действие настраивает цикл и определяет входную коллекцию. В этой роли можно использовать действие Get Incident или Get Virtual Machine .
Контейнер цикла. Это действие с именем ForEachChildActivity содержит действия цикла. Большинство действий Windows Workflow Foundation (WF), которые вы размещаете в этом контейнере, имеют два дополнительных свойства: Текущий элемент и Свойство для привязки. Для каждого действия в контейнере цикла настройте эти свойства следующим образом:
Присвойте свойству Current Item действия «Контейнер циклов» действия ForEach. Если это действие является первым действием в цикле For Each , текущий элемент задается автоматически.
Присвойте свойству свойство Bind значение свойства текущего действия, использующего значение Текущего элемента .
Два типа действий не получают свойства Current Item и Property для привязки и поэтому не могут использовать объекты во входной коллекции:
Действия скрипта, например действие скрипта Windows PowerShell.
Пользовательские действия или другие действия, которые не наследуются от класса WorkflowActivityBase . К таким действиям относятся действия, основанные на базовом классе Activity , например собственные действия Visual Studio.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие Цикл For Each использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Входная коллекция | InputCollection | Массив или объект | Н/Д | Коллекция объектов, передаваемых по одному в действия цикла For Each . Если действие, которое находится во входном контейнере, создает массив объектов в качестве выходного свойства, input Collection автоматически присваивается для этого свойства. Чтобы просмотреть текущее значение этого свойства, щелкните правой кнопкой мыши контейнер цикла и выберите Свойства. |
Текущий элемент | CurrentItem | Объект | Н/Д | Индекс во входной коллекции, который действия в цикле могут использовать в качестве входного свойства. Для первого действия в контейнере цикла это свойство задается автоматически. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие Цикл For Each использует пользовательскую службу отслеживания, предоставляемую Service Manager для регистрации ошибок и исключений при выполнении действия. Это действие создает ошибки или исключения при следующих условиях: — Если в действии ForEachLoop возникает ошибка, которая не связана с дочерними действиями, рабочий процесс завершается. — Если в дочерних действиях возникает какая-либо ошибка, рабочий процесс завершается, если только continueOnError=true. — Если какое-либо из входных свойств имеет значение NULL. Действие не выполняет итерацию. Каждое действие в действии For Each Loop должно записывать собственные ошибки или исключения в настраиваемую службу отслеживания. Само действие цикла For Each не делает этого. |
None | None |
Действие IfElse
Это действие управляет последовательностью действий в рабочем процессе на основе логического условия (истина или ложь). Для условия можно использовать результат предыдущего действия (например, действия сценария).
Действие IfElse — это действие Visual Studio, которое использует правила и условия. Дополнительные сведения об использовании правил и условий в Windows Workflow Foundation (WF) см. в разделе Руководство. Использование правил и условий в WF в библиотека MSDN.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Нет.
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | Дополнительные сведения о действии IfElse см. в разделе Класс IfElseActivity в библиотеке классов платформа .NET Framework 4. | None |
Параллельное действие
Этот тип действия разделяет последовательность действий на две одновременно выполняющиеся последовательности действий. Действие Parallel является действием Visual Studio. Дополнительные сведения о классе ParallelActivity см. в разделе Класс ParallelActivity в библиотеке классов платформа .NET Framework.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Нет.
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | None | None |
Действия Virtual Machine Manager
Используйте действия по управлению виртуальными машинами в Service Manager для создания рабочих процессов, позволяющих создавать и обновлять виртуальные машины. Действия по управлению виртуальными машинами поддерживают System Center Virtual Machine Manager.
Средство разработки Service Manager предоставляет следующие пять действий по управлению виртуальными машинами по умолчанию в группе Действия VMM на панели элементов действий.
Получение действия виртуальной машины
Это действие в Service Manager извлекает список из одной или нескольких идентификаторов виртуальных машин из библиотеки Virtual Machine Manager (VMM).
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | — Консоль Virtual Machine Manager и Service Manager должны быть установлены на одном сервере. — Убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в доменные службы Active Directory (AD DS). — Консоль Virtual Machine Manager и Service Manager должны быть установлены на одном сервере. — Убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в доменные службы Active Directory (AD DS). |
Свойства
Действие Get VM использует входные свойства, приведенные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Набор параметров | ParameterSet | Строка | Нет; Значение по умолчанию — Подключение. | Задает подмножество параметров, упорядоченных для определенной цели. Для действия Получить виртуальную машину можно выбрать один из следующих наборов параметров: - Все: Выполните поиск всех доступных виртуальных машин. - ID: Выполните поиск виртуальной машины с известным идентификатором. - Подключения: Выполните поиск виртуальных машин, подключенных к серверу Virtual Machine Manager (VMM), назначенному свойством VMMServer . - VMHostGroup: Выполните поиск виртуальных машин, подключенных к узлу виртуальной машины, назначенному свойством Узел виртуальной машины . |
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Все | Все | Логическое | Нет. (Значение по умолчанию — True.) | Доступно, если параметр имеет значениеAll. Если задано значение True, действие Получить виртуальную машину возвращает список идентификаторов всех доступных виртуальных машин. |
ID | ID | Строка | Требуется, если параметр Set имеет идентификатор. | Доступно, если набор параметров имеет значение ID. Если задано значение True, действие Получить виртуальную машину возвращает список идентификаторов виртуальных машин всех виртуальных машин, идентификаторы виртуальных машин которых соответствуют всем значениям идентификатора или их части. |
Группа управления | ManagementGroup | Строка | Нет | Указывает группу управления, в которой будет выполняться это действие. Задайте для значение localhost. (Только для чтения.) |
Сервер сценариев | целевого объекта | Строка | Да | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное число секунд, в течение которого разрешено выполнение действия. |
Узел ВМ | VMHost | Строка | Требуется, если набор параметров имеет значениеVMHostGroup | Доступно, если набор параметров имеет значение VMHostGroup. Если этот набор параметров выбран, действие Получить виртуальную машину возвращает список идентификаторов виртуальных машин всех виртуальных машин, работающих на указанном узле. |
Имя виртуальной машины | VMName | Строка | Нет | Указывает имя или часть имени виртуальной машины для поиска. Если строка является частью имени, действие извлекает идентификаторы всех виртуальных машин, содержащих строку. |
VMMServer | VMMServer | Строка | Да | Указывает имя сервера System Center Virtual Machine Manager (VMM), который управляет виртуальными машинами. |
Действие Получить виртуальную машину создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Type | Комментарии |
---|---|---|---|
Идентификаторы ВМ | VMIDList | Массив строк | Указывает список идентификаторов виртуальных машин с именами, которые соответствуют всем или части строки имени виртуальной машины . |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие Get VM использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Перемещение действия виртуальной машины
Это действие в Service Manager перемещает виртуальную машину из библиотеки Virtual Machine Manager (VMM) на узел обслуживания.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | — Консоль Virtual Machine Manager и Service Manager должны быть установлены на одном сервере. — Убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в доменные службы Active Directory (AD DS). |
Свойства
Действие Перемещение виртуальной машины использует входные свойства, приведенные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Блокировать динамическую миграцию, если узел занят | BlockLMIfHostBusy | Логическое | Нет. (Значение по умолчанию — False.) | Блокирование повторной попытки динамической миграции Hyper-V, если сбой миграции произошел из-за того, что узел источника или узел назначения уже участвует в другой динамической миграции. |
Группа заданий | JobGroup | Идентификатор GUID (строка) | Нет | Задает идентификатор ряда команд, выполняемых в виде набора. |
Переменная задания | JobVariable | Строка | Нет | Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре. |
Группа управления | ManagementGroup | Строка | Нет | Указывает группу управления, в которой будет выполняться это действие. Задайте для значение localhost. (Только для чтения.) |
Путь | Путь | Строка | Нет | Указывает назначение виртуальной машины на узле обслуживания. |
PROTipID | PROTipID | Guid | Нет | Указывает идентификатор совета по оптимизации производительности и ресурсов (PRO), запустившего это действие. Позволяет в будущем выполнять аудит советов по PRO. |
Выполнять асинхронно | RunAsynchronously | Логическое | Нет. (Значение по умолчанию — False.) | Указывает, что задание выполняется асинхронно, поэтому управление немедленно возвращается командной оболочке. |
Сервер сценариев | целевого объекта | Строка | Да | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное число секунд, в течение которого разрешено выполнение действия. |
Запустить ВМ на целевом объекте | StartVMOnTarget | Логическое | Нет. (Значение по умолчанию — False.) | Указывает, что виртуальная машина запустится, как только достигнет своего узла назначения. |
Использовать кластер | UseCluster | Логическое | Нет. (Значение по умолчанию — False.) | Принудительное использование средства миграции кластера Windows Server 2008 для переноса виртуальной машины в сохраненном состоянии на узел, даже если кластер поддерживает динамическую миграцию Hyper-V. |
Использовать локальную сеть | UseLan | Логическое | Нет. (Значение по умолчанию — False.) | Принудительный перенос через локальную сеть (LAN), даже если доступен более быстрый механизм переноса, например сеть хранения данных (SAN). |
Узел ВМ | VMHostName | Строка | Да | Указывает имя узла обслуживания, на который будет перемещена виртуальная машина. |
Идентификатор виртуальной машины | VMID | Строка | Да | Указывает уникальный идентификатор виртуальной машины, которая будет перемещена. |
Сервер VMM | VMMServer | Строка | Да | Указывает имя сервера System Center Virtual Machine Manager (VMM), который управляет виртуальными машинами. |
Действие Перемещение виртуальной машины создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Type | Комментарии |
---|---|---|---|
Идентификатор виртуальной машины | VMID | Строка | Указывает уникальный идентификатор виртуальной машины, которая была перемещена. Входной идентификатор виртуальной машины и идентификатор выходной виртуальной машины равны, если не удалось найти виртуальную машину с идентификатором виртуальной машины, который соответствует входному идентификатору виртуальной машины. В этом случае выходной идентификатор виртуальной машины имеет значение Null. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие Перемещения виртуальной машины использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Действие завершения работы виртуальной машины
Это действие в Service Manager завершает работу гостевой операционной системы на виртуальной машине.
Действие Завершение работы виртуальной машины на виртуальной машине на узле под управлением Windows (узле Hyper-V или виртуальном сервере) можно использовать только в том случае, если на виртуальной машине установлены гостевые службы виртуализации. Для виртуальной машины, развернутой на узле Hyper-V, гостевые службы виртуализации называются компонентами интеграции. Для виртуальной машины, развернутой на узле Virtual Server, гостевые службы виртуализации называются дополнениями к виртуальной машине.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | — Консоль Virtual Machine Manager и Service Manager должны быть установлены на одном сервере. — Убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в доменные службы Active Directory (AD DS). |
Свойства
Действие завершения работы виртуальной машины использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Переменная задания | JobVariable | Строка | Нет | Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре. |
Группа управления | ManagementGroup | Строка | Нет | Указывает группу управления, в которой будет выполняться это действие. Задайте для значение localhost. (Только для чтения.) |
PROTipID | PROTipID | Guid | Нет | Указывает идентификатор совета по оптимизации производительности и ресурсов (PRO), запустившего это действие. Позволяет в будущем выполнять аудит советов по PRO. |
Выполнять асинхронно | RunAsynchronously | Логическое | Нет. (Значение по умолчанию — False.) | Указывает, что задание выполняется асинхронно, поэтому управление немедленно возвращается командной оболочке. |
Сервер сценариев | целевого объекта | Строка | Да | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте Localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное число секунд, в течение которого разрешено выполнение действия. |
Идентификатор виртуальной машины | VMID | Строка | Да | Указывает уникальный идентификатор виртуальной машины, работа которой будет завершена. |
VMMServer | VMMServer | Строка | Да | Указывает имя сервера System Center Virtual Machine Manager (VMM), который управляет виртуальными машинами. |
Действие Завершения работы виртуальной машины создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Type | Комментарии |
---|---|---|---|
Идентификатор виртуальной машины | VMID | Строка | Указывает уникальный идентификатор виртуальной машины, работа которой была завершена. Входные идентификаторы виртуальной машины и выходные идентификаторы виртуальной машины равны, если не удалось найти виртуальную машину с идентификатором виртуальной машины , который соответствует входному идентификатору виртуальной машины. В этом случае выходному идентификатору виртуальной машины присваивается значение Null. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие Завершения работы виртуальной машины использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Запуск действия виртуальной машины
Это действие в Service Manager запускает остановленную или приостановленную виртуальную машину.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие Запуска виртуальной машины использует входные свойства, приведенные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Переменная задания | JobVariable | Строка | Нет | Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре. |
Группа управления | ManagementGroup | Строка | Нет | Группа управления, в которой будет выполняться это действие. Задайте для значение localhost. (Только для чтения.) |
PROTipID | PROTipID | Guid | Нет | Указывает идентификатор совета по оптимизации производительности и ресурсов (PRO), запустившего это действие. Позволяет в будущем выполнять аудит советов по PRO. |
Выполнять асинхронно | RunAsynchronously | Логическое | Нет. (Значение по умолчанию — False.) | Указывает, что задание выполняется асинхронно, поэтому управление немедленно возвращается командной оболочке. |
Сервер сценариев | целевого объекта | Строка | Да | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное число секунд, в течение которого разрешено выполнение действия. |
Идентификатор виртуальной машины | VMID | Строка | Да | Указывает уникальный идентификатор виртуальной машины, которая будет запущена. |
VMMServer | VMMServer | Строка | Да | Указывает имя сервера System Center Virtual Machine Manager (VMM), который управляет виртуальными машинами. |
Действие Запуск виртуальной машины создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Type | Комментарии |
---|---|---|---|
Идентификатор виртуальной машины | VMID | Строка | Указывает уникальный идентификатор виртуальной машины, которая была запущена. Входные идентификаторы виртуальной машины и выходные идентификаторы виртуальной машины равны, если не удалось найти виртуальную машину с идентификатором виртуальной машины , который соответствует входному идентификатору виртуальной машины. В этом случае выходному идентификатору виртуальной машины присваивается значение Null. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие Запуска виртуальной машины использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Сохранение активности виртуальной машины состояния
Это действие в Service Manager сохраняет состояние виртуальной машины, а затем останавливает виртуальную машину.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | — Консоль Virtual Machine Manager и Service Manager должны быть установлены на одном сервере. — Убедитесь, что учетная запись рабочего процесса Service Manager имеет достаточные разрешения для изменения групп безопасности в доменные службы Active Directory (AD DS). |
Свойства
Действие Сохранить состояние виртуальной машины использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Переменная задания | JobVariable | Строка | Нет | Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре. |
Группа управления | ManagementGroup | Строка | Нет | Указывает группу управления, в которой будет выполняться это действие. Задайте для значение localhost. (Только для чтения.) |
PROTipID | PROTipID | Guid | Нет | Указывает идентификатор совета по оптимизации производительности и ресурсов (PRO), запустившего это действие. Позволяет в будущем выполнять аудит советов по PRO. |
Выполнять асинхронно | RunAsynchronously | Логическое | Нет. (Значение по умолчанию — False.) | Указывает, что задание выполняется асинхронно, поэтому управление немедленно возвращается командной оболочке. |
Сервер сценариев | целевого объекта | Строка | Да | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное число секунд, в течение которого разрешено выполнение действия. |
Идентификатор виртуальной машины | VMID | Строка | Да | Указывает уникальный идентификатор виртуальной машины, которая будет сохранена. |
Сервер VMM | VMMServer | Строка | Да | Указывает имя сервера System Center Virtual Machine Manager (VMM), который управляет виртуальными машинами. |
Действие Сохранить состояние виртуальной машины создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Type | Комментарии |
---|---|---|---|
Идентификатор виртуальной машины | VMID | Строка | Указывает уникальный идентификатор виртуальной машины, которая была сохранена. Входные идентификаторы виртуальной машины и выходные идентификаторы виртуальной машины равны, если не удалось найти виртуальную машину с идентификатором виртуальной машины , который соответствует входному идентификатору виртуальной машины. В этом случае выходному идентификатору виртуальной машины присваивается значение Null. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие сохранить состояние виртуальной машины использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Действия скрипта
Используйте действие скрипта в Service Manager для запуска скрипта в рамках рабочего процесса.
Действия сценариев выполняются отдельно от рабочих процессов. Однако они также выполняются в контексте безопасности учетной записи рабочего процесса Service Manager.
Средство разработки Service Manager предоставляет следующие три действия скрипта по умолчанию в подгруппе Универсальные действия скриптов группы Действия скрипта на панели Панель элементов действий.
Действие командного скрипта
Это действие выполняет сценарий командной строки в рамках рабочего процесса Windows Workflow Foundation (WF).
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие командного скрипта использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Группа управления | ManagementGroupName | Строка | Нет | Задает группу управления, к которой принадлежит сервер сценариев. По умолчанию для этого параметра задано значение localhost. (Только для чтения.) |
Параметры сценария | Параметры | Строка словаря <, строка> | Да | Задает параметры командной строки или пары "ключ — значение" для передачи в сценарий при его запуске. |
Текст сценария | ScriptBody | Строка | Да | Задает текст самого сценария. |
Сервер сценариев | целевого объекта | Строка | Нет | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное время в секундах, в течение которого разрешено выполнение сценария. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие командного скрипта использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Действие скрипта Windows PowerShell
Это действие в Service Manager запускает скрипт Windows PowerShell как часть рабочего процесса Windows Workflow Foundation (WF).
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
Действие скрипта Windows PowerShell зависит от следующих предварительных требований во время разработки. — Windows PowerShell 2.0 |
Windows PowerShell 2.0 |
Свойства
Действие скрипта Windows PowerShell использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Группа управления | ManagementGroupName | Строка | Нет | Задает группу управления, к которой принадлежит сервер сценариев. По умолчанию для этого параметра задано значение localhost. (Только для чтения.) |
Параметры сценария | Параметры | Строка словаря <, строка> | Да | Указывает список параметров (имен и значений) для передачи в сценарий при запуске. В качестве значений параметров можно задать любые из следующих ссылок на пакет управления: - $Target/...$ - $MPElement[...] - $Data/...$. Ссылки $Data разрешаются только во время выполнения в параметрах (не в самом сценарии). Использование одной из этих ссылок в качестве единственного значения для параметра задает этот параметр для XML-строки, представляющей элемент входных данных (из GetItemXML). |
Текст сценария | ScriptBody | Строка | Да | Задает текст самого сценария. |
Оснастки | SnapIns | Строка | Нет | Списки Windows PowerShell оснастки для предварительной загрузки в пространство выполнения. |
Сервер сценариев | целевого объекта | Строка | Нет | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное время в секундах, в течение которого разрешено выполнение сценария. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие скрипта Windows PowerShell использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | Дополнительные сведения о Windows PowerShell см. в разделе Windows PowerShell. | None |
Действие скрипта VBScript
Это действие в Service Manager запускает скрипт VBScript как часть рабочего процесса Windows Workflow Foundation (WF).
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
Действие скрипта VBScript зависит от следующих предварительных требований во время разработки: Нет. |
None |
Свойства
Действие скрипта VBScript использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Содержит ошибку | HasError | Н/Д | Указывает, задана ли в действии ошибка. (Только для чтения.) | |
Группа управления | ManagementGroupName | Строка | Нет | Задает группу управления, к которой принадлежит сервер сценариев. (По умолчанию для этого параметра задано значение localhost) (только для чтения) |
Параметры сценария | Параметры | Строка словаря <, строка> | Да | Предоставляет список стандартных параметров и соответствующих значений, используемых при выполнении сценария. |
Текст сценария | ScriptBody | Строка | Да | Задает текст самого сценария. |
Сервер сценариев | целевого объекта | Строка | Нет | Указывает имя сервера, на котором выполняется консоль Service Manager, в службе доменных имен (DNS). Не используйте localhost. |
Временное ограничение сценария | TimeoutSeconds | Целочисленный тип | Нет. (Значение по умолчанию — 300 секунд.) | Указывает максимальное время в секундах, в течение которого разрешено выполнение сценария. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Действие скрипта VBScript использует пользовательскую службу отслеживания, предоставляемую Service Manager, для регистрации ошибок и исключений при выполнении действия. Действие создает ошибки или исключения, если не удается устранить какие-либо свойства скрипта. | None | None |
Действия Service Manager
Используйте действия Service Manager в Service Manager, чтобы Service Manager функции были частью рабочего процесса.
Средство разработки Service Manager предоставляет следующие четыре действия Service Manager по умолчанию в группе Действия SM на панели элементов действий.
Создание действия по инциденту
Это действие создает и заполняет инцидент в Service Manager.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие Создать инцидент использует входные свойства, перечисленные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Комментарии |
---|---|---|---|---|
ИД инцидента | IncidentID | Строка | Да | Указывает уникальный идентификатор, созданный для объекта Incident . |
Комментарий к журналу действий | ActionLogComment | Строка | Да | Указывает комментарий для включения в журнал действий объекта Incident . |
Домен затронутого пользователя | AffectedUserDomain | Строка | Да | Указывает имя домена основного пользователя, затронутого инцидентом, в службе доменных имен (DNS). |
Имя затронутого пользователя | AffectedUserName | Строка | Да | Указывает имя основного пользователя, затронутого инцидентом. |
Категория | Категория | Целочисленный тип | Да | Указывает тип инцидента, например сеть или печать. Значением является идентификатор перечисления. (Поле данных Category -enum ) |
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Влияние | Влияние | Целочисленный тип | Да | Указывает влияние инцидента на затрагиваемого пользователя или пользователей. Значением является идентификатор перечисления. (Тип данных Impact -enum ) |
Source | Source | Целое число | Нет | Указывает источник сведений об инциденте, например Телефон или Электронная почта. Значением является идентификатор перечисления. (Поле типа данных Source -enum ) |
Сводка | Сводка | Строка | Да | Задает текст с описанием инцидента. |
"Срочность"; | "Срочность"; | Целочисленный тип | Да | Указывает срочность разрешения инцидента. Значением является идентификатор перечисления. (Поле типа данных "Срочность - перечисление ") |
Действие Создать инцидент создает выходные данные, описанные в следующей таблице.
Имя | Type | Комментарии |
---|---|---|
Инцидент SM | System.WorkItem.Incident | Возвращает сконструированный экземпляр класса инцидента. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | None | None |
Получение действия по инциденту
Это действие извлекает один или несколько инцидентов в Service Manager.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие Get Incident использует входные свойства, перечисленные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Комментарии |
---|---|---|---|---|
Домен затронутого пользователя | AffectedUserDomain | Строка | Нет | Указывает имя домена основного пользователя, затронутого инцидентом, в службе доменных имен (DNS). |
Имя затронутого пользователя | AffectedUserName | Строка | Нет | Указывает имя основного пользователя, затронутого инцидентом. |
Категория | Категория | Целое число | Нет | Указывает тип инцидента, например сеть или печать. Значением является идентификатор перечисления. (Поле данных Category -enum ) |
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
ИД инцидента | IncidentID | Строка | Нет | Задает уникальный идентификатор, созданный для объекта инцидента. |
Тип поиска | SearchType | Целое число? | Нет | Задает название типа поиска, который используется с действием. |
Состояние | Состояние | Целое число | Нет | Указывает состояние инцидента. Значением является идентификатор перечисления. (Поле данных Status -enum ) |
Текстовое содержание сводки | SummaryText | Строка | Нет | Задает текст с описанием инцидента. |
Действие Get Incident создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Type | Комментарии |
---|---|---|---|
Инциденты SM | SMIncidents | Массив объектов System.Workitem.Incident | Задает массив объектов инцидентов. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | Действие Get Incident имеет собственный проверяющий элемент управления для проверки ошибок входных свойств. | None |
Обновление действия инцидента
Это действие в Service Manager сохраняет изменения свойств в одном инциденте Service Manager.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | None |
Свойства
Действие Update Incident использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Комментарий к журналу действий | ActionLogComment | Строка | Нет | Указывает комментарий для включения в журнал действий объекта Incident. |
Домен затронутого пользователя | AffectedUserDomain | Строка | Нет | Указывает имя домена основного пользователя, затронутого инцидентом, в службе доменных имен (DNS). |
Имя затронутого пользователя | AffectedUserName | Строка | Нет | Указывает имя основного пользователя, затронутого инцидентом. |
Категория | Категория | Целое число | Нет | Указывает тип инцидента, например сеть или печать. Значением является идентификатор перечисления. (Тип данных Category -enum ) |
Продолжать при ошибке | ContinueOnError | Логическое | Нет. (Значение по умолчанию — True.) | Определяет, будет ли продолжаться рабочий процесс при сбое этого действия. |
Влияние | Влияние | Целое число | Нет | Указывает влияние инцидента на затрагиваемого пользователя или пользователей. Значением является идентификатор перечисления. (Тип данных Impact -enum ) |
Source | Source | Целое число | Нет | Указывает источник сведений об инциденте, например Телефон или Электронная почта. Значением является идентификатор перечисления. (Тип данных Source -enum ) |
Инцидент Service Manager | SMIncident | System.Workitem.Incident | Нет | Сконструированный экземпляр класса инцидента, который будет обновлен. |
Состояние | Состояние | Целое число | Нет | Указывает состояние инцидента, создавшего действие. Значением является идентификатор перечисления. (Тип данных Status -enum ) |
Сводка | Сводка | Строка | Нет | Задает текст с описанием инцидента. |
"Срочность"; | "Срочность"; | Целое число | Нет | Указывает срочность разрешения инцидента. Значением является идентификатор перечисления. (Поле типа данных "Срочность - перечисление ") |
Действие Update Incident создает выходные данные, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Описание |
---|---|---|---|
Инцидент SM | SMIncident | System.WorkItem.Incident | Возвращает обновление экземпляра класса инцидента. Входной инцидент SM и выходной инцидент SM равны, если действия не удалось найти инцидент SM. В этом случае для выходных данных SM Incident задано значение Null. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | None | None |
Установите состояние действия в состояние Завершено.
Это действие обновляет состояние автоматического действия в Service Manager.
Предварительные требования к времени разработки | Предварительные требования к времени выполнения |
---|---|
None | Нет. |
Свойства
Действие Задать состояние действия Завершено использует входные свойства, описанные в следующей таблице.
Отображаемое имя | Внутреннее имя | Тип | Обязательно | Описание |
---|---|---|---|---|
Идентификатор действия | Идентификатор действия | Строка | Да | Указывает идентификатор объекта автоматического действия Service Manager. |
Ошибки и исключения | Remarks | Пример |
---|---|---|
Нет | При использовании этого действия в рабочем процессе, который активируется Service Manager автоматизированным действием, введите $Data/BaseManagedEntityId$ в качестве значения этого свойства. Это значение применяется к действию Set Activity Status (Состояние действия) для действия Completed (Завершено ) в автоматическом действии, которое активировало рабочий процесс. | None |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по