Управление агентами расширения командлетов

  • Статья

Область применения: Exchange Server 2013 г.

В этом разделе показано, как включить, отключить, просмотреть и изменить приоритет агентов расширения командлетов в Microsoft Exchange Server 2013 г. Дополнительные сведения об агентах расширения командлетов в Exchange 2013 см. в разделе Агенты расширения командлетов.

Что нужно знать перед началом работы

  • Предполагаемое время для завершения каждой процедуры: менее 5 минут

  • Для выполнения этой процедуры (процедур) необходимы соответствующие разрешения. Сведения о необходимых разрешениях см. в записи "Агенты расширения командлетов" в разделе Разрешения инфраструктуры Exchange и оболочки .

  • Перед включением Scripting Agentнеобходимо убедиться, что он настроен правильно. Дополнительные сведения о см. в Scripting Agentразделе Агенты расширения командлетов.

  • Для выполнения этих процедур необходимо использовать командную консоль Exchange.

  • Сочетания клавиш для процедур, описанных в этой статье, приведены в статье Сочетания клавиш в Центре администрирования Exchange.

Совет

Возникли проблемы? Обратитесь за помощью к участникам форумов Exchange. Посетите форумы по адресу Exchange Server.

Включение агента расширения командлета

При включении агента расширения командлета в Exchange 2013 агент запускается на каждом сервере Exchange 2013 в организации. Когда агент включен, он доступен для использования командлетами для выполнения дополнительных операций.

Предупреждение

Перед включением агента убедитесь, что полностью осведомлены о работе агента и его влиянии на организацию.

В этом примере включается агент расширения командлета с помощью командлета Enable-CmdletExtensionAgent. Необходимо указать имя агента для включения при запуске командлета. Перед включением Scripting Agentнеобходимо убедиться, что файл конфигурации развернут ScriptingAgentConfig.xml на всех серверах в организации. Если сначала не развернуть файл конфигурации и включить Scripting ``Agent, при запуске все командлеты, отличные от Get , завершаются ошибкой. В этом примере включается Scripting Agent.

Enable-CmdletExtensionAgent "Scripting Agent"

Дополнительные сведения о синтаксисе и параметрах см. в разделе Enable-CmdletExtensionAgent.

Выключение агента расширения командлета

При отключении агента расширения командлета в Exchange 2013 агент отключается на каждом сервере Exchange 2013 в организации. При отключении агент становится недоступным для командлетов. Командлеты больше не смогут использовать этот агент для выполнения дополнительных операций.

Предупреждение

Перед отключением агента рекомендуется изучить принципы работы агента и влияние отключения агента на работу организации.

Чтобы отключить агент расширения командлета, используйте командлет Disable-CmdletExtensionAgent. При запуске командлета необходимо указать имя отключаемого агента. В этом примере отключается Scripting Agent.

Disable-CmdletExtensionAgent "Scripting Agent"

Дополнительные сведения о синтаксисе и параметрах см. в разделе Disable-CmdletExtensionAgent.

Просмотр существующих агентов расширения командлетов

Просмотр агентов расширения командлетов позволяет узнать, какие агенты запускаются первыми и какие агенты включены в организации Exchange 2013. Дополнительные сведения о передаче по конвейеру и командлете Format-Table см. в следующих разделах.

В этом примере показано, как получить дополнительные сведения об определенном агенте расширения командлета с помощью командлета Get-CmdletExtensionAgent. В этом примере возвращаются сведения о объекте Mailbox Permissions Agent .

Get-CmdletExtensionAgent "Mailbox Permissions Agent"

В этом примере показано, как получить сведения о нескольких агентах расширения командлета с помощью командлета Get-CmdletExtensionAgent, а затем передать по конвейеру выходные данные в командлет Format-Table. В этом примере отображается список всех агентов расширения командлета в организации, а с помощью командлета Format-Table свойства Name, Enabled и Priority каждого агента отображаются в таблице.

Get-CmdletExtensionAgent | Format-Table Name, Enabled, Priority

Дополнительные сведения о синтаксисе и параметрах см. в разделе Get-CmdletExtensionAgent.

Изменение приоритета агента расширения командлета

Возможность изменения приоритета агента расширения командлетов в Exchange 2013 полезна, если требуется, чтобы определенный агент вызывался командлетом перед другим агентом. Это особенно полезно, если вы создаете пользовательский скрипт, который выполняется в Scripting Agent, и требуется, чтобы он был приоритетом над встроенным агентом. Дополнительные сведения о см. в Scripting Agentразделе Агенты расширения командлетов.

Предупреждение

Изменение приоритета или замена функций встроенного агента являются дополнительными операциями. Убедитесь, что имеете полное представление о производимых изменениях.

Агенты упорядочены от нуля до максимального числа агентов. Чем ближе агент расположен к нулю, тем выше его приоритет. Агенты с более высоким приоритетом вызываются в первую очередь. Дополнительные сведения о приоритетах агентов см. в разделе Агенты расширения командлетов.

В этом примере показано, как изменить приоритет агента расширения командлета с помощью командлета Set-CmdletExtensionAgent. В этом примере приоритет Scripting Agent объекта изменяется на 3.

Set-CmdletExtensionAgent "Scripting Agent" -Priority 3

Дополнительные сведения о синтаксисе и параметрах см. в разделе Set-CmdletExtensionAgent.