Агенти розширення командлет

Агенти дозволяють змінювати, замінювати або розширювати функції командлетів консолі управління Exchange. Агент дозволяє вказати значення необхідного параметра, яке не зазначено в команді, замінити певний користувачем значення, виконувати інші дії за межами робочого потоку командлет під час роботи командлет і т. Д.

Необхідні відомості про інших завданнях управління, пов'язаних з агентами розширення командлетів? Див. Розділ Управління агентами розширення командлетів.

Пріоритет агента визначає порядок виклику агентів під час роботи командлет. Агент з більш високим пріоритетом (ближче до 0) викликається в першу чергу. Пріоритет агента дуже важливий, коли два або більше агентів намагаються встановити значення одного властивості. Властивість встановлює агент з найбільш високим пріоритетом, а всі наступні спроби установки цього ж властивості агентами з більш низьким пріоритетом пропускаються. Наприклад, якщо властивість Name об'єкта змінено агентом з пріоритетом 3, і інший агент з пріоритетом 6 спробує змінити цей же об'єкт, зміни агента з пріоритетом 6 будуть пропущені.

Щоб використовувати Scripting agent для установки значень властивостей, які можуть бути встановлені іншими агентами з більш високим пріоритетом, виконайте наступні дії.

Встановіть для Scripting agent пріоритет вище, ніж у існуючого агента, який необхідно замінити.

Не змінюйте пріоритети агентів і переконайтеся, що сценарій, запущений в Scripting agent. враховує значення, надане іншими агентами.

Зміна пріоритету або заміна функцій вбудованого агента є додатковими операціями. Переконайтеся, що маєте повне уявлення про вироблені зміни.

Додаткові відомості про зміну пріоритету агента, див. Розділ Управління агентами розширення командлетів.

Конфігурація агентів зберігається на рівні організації. При включенні, відключенні агента або установці його пріоритету зміна конфігурації агента виконується на кожному сервері організації. Винятком є ​​додавання сценаріїв в Scripting agent. Оновлення сценаріїв необхідно виконувати окремо на кожному сервері. Дополнительные сведения о настройке сценариев для использования с Scripting agent см. в разделе "Агент сценария" далее в этом разделе.

У разі нерозуміння принципів роботи агентів і способів їх взаємодії з Командлети Exchange зміна пріоритету агентів, їх включення або відключення може призвести до непередбачених наслідків. Перед зміною конфігурації агента переконайтеся, що маєте повне уявлення про виконувані зміни і бажані результати, і перевірте правильність роботи настроюється сценарію.

При кожному запуску командлета Exchange викликається агент розширення командлет Scripting agent. При виклику цього агента командлет перевіряє, чи потрібно виконання будь-якого сценарію. Якщо для командлет налаштоване виконання сценарію, командлет намагається зателефонувати за одним з інтерфейсів API, визначених у сценарії. У сценарії доступні наступні API, що викликаються в зазначеному нижче порядку.

ProvisionDefaultProperties Цей API використовується для настройки значень властивостей об'єктів при їх створенні. При встановленні значення воно повертається Командлети, який встановлює його для властивості. Адміністратор може задати значення для властивостей, якщо вони не були вказані користувачем, або може перевизначити значення, вказане користувачем. Цей API враховує значення, встановлені агентами з більш високим пріоритетом. Агент розширення командлет Scripting agent не переважають значення, встановлені агентами з більш високим пріоритетом.

UpdateAffectedIConfigurable Цей API використовується для установки значень властивостей об'єктів після завершення всіх інших процесів обробки і до виклику інтерфейсу API Validate. Цей API враховує значення, встановлені агентами з більш високим пріоритетом. Агент розширення командлет Scripting agent не переважають значення, встановлені агентами з більш високим пріоритетом.

Validate Цей API використовується для перевірки значень властивостей об'єктів, які будуть встановлені Командлети. Він викликається безпосередньо перед записом Командлети будь-яких даних. Проверку можно настроить таким образом, чтобы командлет мог пройти или не пройти ее. Якщо командлет проходить перевірку в цьому API, то йому дозволяється запис даних. Якщо командлет не проходить перевірку, він повертає помилку, визначену в цьому API.

OnComplete Цей API використовується після завершення всіх операцій обробки командлет. Он может использоваться для выполнения задач после обработки, таких как запись данных во внешнюю базу данных.

Цей елемент містить функції, які можуть використовуватися будь-яким сценарієм в файлі конфігурації.

Деякі символи, які зазвичай використовуються в сценаріях, також мають певне значення в мові XML. Для використання цих символів в сценарії необхідно використовувати escape-послідовності. Наприклад, для наступних символів використовуються escape-послідовності.

Замість символу «більше, ніж» (>) використовуйте gt;

Замість символу «менше, ніж» ( <) используйте $lt;

Замість амперсанда ( ) Використовуйте -

Щоб включити Scripting agent. виконайте наступні дії.

Увімкніть агент розширення командлет Scripting agent. Додаткові відомості про включення агентів розширення командлет см. В розділі Управління агентами розширення командлетів.

За замовчуванням агент розширення командлет Scripting agent запускається після кожного другого агента, крім агента Scripting agent. Якщо необхідно, щоб існуючий агент був замінений створеним сценарієм, вимкніть інший агент або змініть пріоритет обох агентів, щоб агент Scripting agent запускався першим. Додаткові відомості про способи відключення або змінити пріоритет агентів см. В розділі Управління агентами розширення командлетів.