Действия администратора ExchangeExchange Administrator Activities

Важно!

Эта версия Orchestrator достигла конца поддержки, мы рекомендуем выполнить обновление до Orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

Следующие инструкции по настройке применяются ко всем действиям, выполняемым в пакете интеграции администрирования Exchange.The following configuration instructions apply to all activities that are performed in the Exchange Admin Integration Pack. В подробных разделах конфигурации для конкретных действий администратора Exchange содержатся ссылки на эти общие инструкции.The detailed configuration topics for specific Exchange Admin activities all contain links back to these general instructions.

Каждая процедура в этом разделе выполняется для действия, которое было помещено в окно Runbook Runbook Designer Orchestrator.Each procedure in this topic is performed on an activity that has been placed in the runbook window of the Orchestrator Runbook Designer.

Свойства действияActivity properties

Для каждого действия настраивается набор обязательных или необязательных свойств.Each activity is configured with a set of required or optional properties. Они определяют, как действие подключается к другим действиям или как действие выполняет его действия.These define how the activity connects to other activities or how the activity performs its actions. Когда в окно Runbook помещается действие, можно просмотреть или изменить его свойства.When an activity has been placed in the runbook window, you can view or modify its properties.

Примечание

Свойство должно иметь значение, в противном случае свойство не будет передано действию.The property needs to have a value, otherwise the property will not be passed to the activity. Пустая строка или пробелы не считаются допустимыми значениями.An empty string or spaces are not considered valid value. Например, действие "почтовые ящики" имеет идентификатор свойства.e.g. GetMailbox activity has a property Identity. Если значение для этого удостоверения свойства передается "" или "", свойство Identity будет пропущено.If the value for this property Identity is passed "" or " ", then the Identity property will be omitted.

Просмотр и Настройка свойств действияTo view and configure the properties for an activity

  1. Дважды щелкните действие.Double-click the activity. Кроме того, можно щелкнуть действие правой кнопкой мыши и выбрать пункт Свойства.Alternatively, you can right-click the activity, and then click Properties.
  2. При необходимости просмотрите и настройте свойства действия.View and configure the activity properties as needed.
  3. Чтобы сохранить записи конфигурации, нажмите кнопку Готово.To save your configuration entries, click Finish.

В диалоговом окне Свойства действия различные вкладки предоставляют доступ к общим и определенным параметрам для действия.In the activity properties dialog box, various tabs provide access to general and specific settings for the activity. Количество доступных вкладок для свойств объекта зависит от действия.The number of available tabs for object properties will vary according to the activity.

Вкладка «Общее»General tab

Вкладка Общие содержит свойства имя и Описание для действия.The General tab contains the Name and Description properties for the activity. По умолчанию имя действия совпадает с типом действия, а Описание — пустым.By default, the Name of the activity is the same as its activity type and the Description is blank. Эти свойства можно изменить, чтобы указать более конкретное имя или добавить описание по мере необходимости.You can modify these properties to provide a more specific name or to add a description as necessary.

Вкладка «Свойства»Properties tab

Вкладка Свойства содержит свойства, относящиеся к конкретному действию.The Properties tab contains properties that are specific to the activity. Все действия в этом пакете интеграции имеют свойство имя конфигурации на вкладке свойства . Свойство имя конфигурации используется для указания соединения с сервером Exchange.All activities in this integration pack have the Configuration Name property on the Properties tab. The Configuration Name property is used to specify the connection to the Exchange server.

Настройка свойства "имя конфигурации"To configure the Configuration Name property

  1. Нажмите кнопку с многоточием (...) рядом с полем имя .Click the ellipsis (...) button next to the Name field.

  2. Выберите подходящее имя подключения.Select the applicable connection name. Подключения, отображаемые в списке, были ранее настроены, как описано в разделе пакет интеграции администрирования Exchange для System Center-Orchestrator.Connections displayed in the list have been previously configured as described in Exchange Admin Integration Pack for System Center - Orchestrator.

Критерии для фильтровCriteria for filters

Действия Get используют фильтры для определения значений, которые будут вызывать Runbook или извлекать действия.The Get activities use filters to determine the values that will invoke a runbook or retrieve activities. Значения свойств потенциальных кандидатов сравниваются со значениями фильтров, чтобы определить, соответствуют ли они критериям.Property values of potential candidates are compared to the values of the filters to determine if they meet the criteria. При указании условий фильтра можно выбрать один из доступных методов сравнения.When you specify filter criteria, you can select one of the available methods of comparison. Система предоставляет возможность либо сопоставить фильтр, либо не соответствовать ему с помощью каждого метода.The system provides an option to either match or not match the filter using each method. Например, версия метода "не соответствует" находит элементы, которые не соответствуют фильтру.For example, the "Does not" version of a method finds items that do not match the filter. Все текстовые фильтры чувствительны к регистру.All text filters are case sensitive.

  • Equals: свойство элемента совпадает с текстом или числом, указанным в фильтре.Equals: The property of the item matches the text or number specified in the filter.
  • Не равно: свойство элемента не соответствует тексту или числу, указанному в фильтре.Does not equal: The property of the item does not match the text or number specified in the filter.
  • Меньше: значение числового свойства элемента меньше числа, указанного в фильтре.Is less than: The numeric property of the item is less than the number specified in the filter.
  • Меньше или равно: числовое свойство элемента меньше или равно числу, указанному в фильтре.Is less than or equal to: The numeric property of the item is less than or equal to the number specified in the filter.
  • Больше чем: числовое свойство элемента больше числа, указанного в фильтре.Is greater than: The numeric property of the item is greater than the number specified in the filter.
  • Больше или равно: числовое свойство элемента больше или равно числу, указанному в фильтре.Is greater than or equal to: The numeric property of the item is greater than or equal to the number specified in the filter.
  • Содержит: свойство элемента содержит точный текст, указанный в фильтре.Contains: The property of the item contains the exact text specified in the filter. Может существовать другой текст, окружающий соответствующий текст.There can be other text surrounding the matching text.
  • Не содержит: свойство элемента не содержит точный текст, указанный в фильтре.Does not contain: The property of the item does not contain the exact text specified in the filter.
  • Соответствует шаблону. Этот метод сравнения использует регулярные выражения для указания шаблона, которому должен соответствовать текст.Matches pattern: This comparison method uses regular expressions to specify a pattern that the text must match.
  • Не соответствует шаблону: Этот метод сравнения использует регулярные выражения для указания шаблона, который не должен совпадать с текстом.Does not match pattern: This comparison method uses regular expressions to specify a pattern that the text must not match.
  • Начинается с: свойство элемента начинается с точного текста, указанного в фильтре.Starts with: The property of the item starts with the exact text specified in the filter.
  • Заканчивается на: свойство элемента заканчивается точным текстом, указанным в фильтре.Ends with: The property of the item ends with the exact text specified in the filter.

Вкладка «поведение при запуске»The Run Behavior tab

Вкладка поведение запуска содержит свойства, определяющие, как действие обрабатывает опубликованные данные с несколькими значениями и какие уведомления будут отправляться в случае сбоя или запуска действия в течение некоторого времени.The Run Behavior tab contains the properties that determine how the activity handles multi-value published data and which notifications will be sent if the activity fails or runs for an excessive period of time.

Несколько значений в опубликованных данныхMultiple values in published data

Действия Get получают сведения из другого действия или за пределами источника, а затем могут возвращать одно или несколько значений в опубликованных данных.The Get activities retrieve information from another activity or outside source and can then return one or more values in the published data. Например, выходные данные действия получение почтового ящика могут быть сведениями о существующем почтовом ящике.For example, the data output from the Get Mailbox activity could be the details of an existing mailbox.

По умолчанию данные из действия Get будут передаваться в виде нескольких отдельных выходов.By default, the data from the Get activity will be passed on as multiple individual outputs. Эти несколько выходов будут вызывать следующее предписанное действие столько раз, сколько имеется элементов в выходных данных.These multiple outputs will invoke the next prescribed activity as many times as there are items in the output. Кроме того, чтобы запросить один объединенный выход для действия, можно включить параметр « сведение ».Alternatively, to request a single combined output for the activity, you can enable the Flatten option. При включении параметра « сведение » необходимо указать выходной формат:When you enable the Flatten option, you must specify the output format:

  • Разделяйте разрывами строк.Separate with line breaks. Каждый элемент находится на новой строке.Each item is on a new line. Этот формат полезен для создания текстовых файлов, пригодных для восприятия.This format is useful for creating human-readable text files.
  • Разделите с.Separate with. Каждый элемент отделяется одним или несколькими выбранными символами.Each item is separated by one or more characters of your choice.
  • Используйте формат CSV.Use CSV format. Все элементы находятся в формате CSV (значение с разделителями-запятыми).All items are in CSV (comma-separated value) format. Этот формат удобен для импорта данных в электронные таблицы или другие приложения.This format is useful for importing data into spreadsheets or other applications.

Действие Get будет создавать новый набор данных при каждом запуске.The Get activity will produce a new set of data every time it runs. Функция « сведение » не выполняет сведение данных между несколькими экземплярами одного действия.The Flatten feature does not flatten data across multiple instances of the same activity.

Уведомления о событиях времени ожидания и сбояTimeout and failure event notifications

Некоторые действия должны занимать лишь ограниченное количество времени.Some activities are expected to take only a limited amount of time to complete. Если они не завершаются в течение ожидаемого времени, они могут быть остановлены, или может возникнуть другая неполадка, препятствующая завершению работы.If they do not complete within an expected timeframe, they may be stalled or there may be another issue preventing completion. Можно определить количество секунд ожидания завершения действия.You can define the number of seconds to wait for completion of the action. Если обработка действия превышает это пороговое значение времени ожидания, будет отправлено событие платформы, и будет сообщено об ошибке.If the processing of the activity exceeds this timeout threshold, a platform event will be sent and the issue will be reported. Кроме того, можно также указать, генерировать ли событие платформы, если действие возвращает отказ.You can also choose whether to generate a platform event if the activity returns a failure.

Получение уведомления о том, что действие занимает больше времени, чем заданное время, или не может быть запущеноTo be notified when the activity takes longer than a specified time to run or fails to run

  1. В поле уведомления о событии введите количество секунд времени выполнения до создания уведомления.In the Event Notifications box, enter the number of seconds of run time before a notification is generated.

  2. Выберите отчет, если не удается запустить действие для создания уведомлений об ошибках запуска.Select Report if activity fails to run to generate run failure notifications.

Опубликованные данныеPublished data

Опубликованные данные — это данные, создаваемые в результате действий действия.Published data is the data produced as a result of the actions of an activity. Эти данные публикуются во внутренней шине данных, которая уникальна для каждого модуля Runbook.This data is published to an internal data bus that is unique for each runbook. Опубликованные данные являются основой рабочего модуля Runbook.Published data is the foundation of a working runbook. Последующие действия в модуле Runbook могут подписываться на эти данные и использовать их в своей конфигурации.Subsequent activities in the runbook can subscribe to this data and use it in their configuration. Условия связи также используют эти сведения для добавления возможностей принятия решений в модули Runbook.Link conditions also use this information to add decision-making capabilities to runbooks.

Действие может подписываться только на данные из действий, которые связаны перед ним в модуле Runbook.An activity can subscribe only to data from the activities that are linked before it in the runbook. Опубликованные данные можно использовать для автоматического заполнения значений свойств, необходимых действиям.You can use published data to automatically populate the property values needed by activities.

Использование опубликованных данныхTo use published data

  1. Щелкните правой кнопкой мыши поле значение свойства, выберите подпишите, а затем — опубликованные данные.Right-click the property value box, click Subscribe, and then click Published Data.
  2. Щелкните раскрывающийся список действие и выберите действие, из которого требуется получить данные.Click the Activity drop-down box and select the activity from which you want to obtain the data. Чтобы просмотреть дополнительные элементы данных, общие для всех модулей Runbook, выберите Показать общие опубликованные данные.To view additional data elements common to all runbooks, select Show Common Published Data.
  3. Выберите элемент опубликованные данные, который требуется использовать, и нажмите кнопку ОК.Click the published data element that you want to use, and then click OK.

Список элементов данных, опубликованных каждым действием, см. в таблице опубликованные данные в разделе "конкретные действия".For a list of the data elements published by each activity, see the Published Data table in the specific activity topic. Сведения об общих элементах опубликованных данных см. в разделе Общие опубликованные данные.For information about the common published data items, see Common Published Data.

ДействияActivities

Этот пакет интеграции добавляет категорию администрирования Exchange в область действий в Runbook Designer.This integration pack adds the Exchange Admin category to the Activity pane in the Runbook Designer. Эта категория содержит следующие действия.This category contains the following activities:

Создание почтового ящика Создать запрос на перемещение Создать удаленный почтовый ящик (гибридный) Отключить почтовый ящик Отключить удаленный почтовый ящик (гибридный) Включить почтовый ящик Включить удаленный почтовый ящик (гибридный) Получение почтового ящика Получить запрос на перемещение Получение статистики запроса на перемещение Получить удаленный почтовый ящик (гибридный) Удалить почтовый ящик Удалить удаленный почтовый ящик (гибридный) Выполнение команды Exchange PowerShell Обновление почтового ящика Обновить запрос на перемещение Обновить удаленный почтовый ящик (гибридный)Create Mailbox Create Move Request Create Remote Mailbox (Hybrid) Disable Mailbox Disable Remote Mailbox (Hybrid) Enable Mailbox Enable Remote Mailbox (Hybrid) Get Mailbox Get Move Request Get Move Request Statistics Get Remote Mailbox (Hybrid) Remove Mailbox Remove Remote Mailbox (Hybrid) Run Exchange PowerShell Command Update Mailbox Update Move Request Update Remote Mailbox (Hybrid)