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

Применимо к: Exchange Server 2013Applies to: Exchange Server 2013

В этом разделе описано, как включить, отключить, просмотреть или изменить приоритет агентов расширения командлетов в Microsoft Exchange Server 2013. Дополнительные сведения об агентах расширения командлетов Exchange 2013 см. в разделе Агенты расширения командлета.This topic shows you how to enable, disable, view, and change the priority of cmdlet extension agents in Microsoft Exchange Server 2013. For more information about cmdlet extension agents in Exchange 2013, see Cmdlet extension agents.

Что нужно знать перед началом работыWhat do you need to know before you begin?

  • Предполагаемое время для завершения каждой процедуры: менее 5 минутEstimated time to complete each procedure: less than 5 minutes

  • Для выполнения этих процедур необходимы соответствующие разрешения. Сведения о необходимых разрешениях см. в статье запись "Агенты расширения командлета" в разделе Разрешения инфраструктуры Exchange и командной консоли.You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Cmdlet extension agents" entry in the Exchange and Shell infrastructure permissions topic.

  • Прежде чем включить Scripting Agent, необходимо убедиться, что он правильно настроен. Дополнительные сведения о Scripting Agent, видеть агенты расширения командлета.Before you enable the Scripting Agent, you must verify that it's configured correctly. For more information about the Scripting Agent, see Cmdlet extension agents.

  • Для выполнения этих процедур необходимо использовать командную консоль Exchange.You must use the Shell to perform these procedures.

  • Сочетания клавиш для процедур, описанных в этой статье, приведены в статье Сочетания клавиш в Центре администрирования Exchange.For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Совет

Возникли проблемы? Обращение за помощью в форумах Exchange. Посетите форумы Exchange Server, Exchange Onlineили Exchange Online Protection.Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Server, Exchange Online, or Exchange Online Protection.

Что необходимо сделать?What do you want to do?

Включение агента расширения командлетаEnable a cmdlet extension agent

При включении агента расширения командлета в Exchange 2013 агент запускается на каждом сервере Exchange 2013 в организации. Когда агент включен, он доступен для использования командлетами для выполнения дополнительных операций.When you enable a cmdlet extension agent in Exchange 2013, the agent is run on every server running Exchange 2013 in the organization. When an agent is enabled, it's made available to cmdlets, which can then use the agent to perform additional operations.

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

Перед включением агента убедитесь, что полностью осведомлены о работе агента и его влиянии на организацию.Before you enable an agent, be sure that you're aware of how the agent works and what impact the agent will have on your organization.

В этом примере показано включение агента расширения командлета с помощью командлета Enable-CmdletExtensionAgent . Необходимо указать имя агента, которые необходимо включить при запуске командлета. Прежде чем включить Scripting Agent, вам нужно убедитесь в том, что вы развернули ScriptingAgentConfig.xml файл конфигурации на всех серверах в вашей организации. Если файл конфигурации не развертывание сначала включить Scripting ``Agent, все-Получение командлеты с ошибкой при запуске. В этом примере показано включение Scripting Agent.This example enables a cmdlet extension agent by using the Enable-CmdletExtensionAgent cmdlet. You must specify the name of the agent you want to enable when you run the cmdlet. Before you enable the Scripting Agent, you need to make sure that you've deployed the ScriptingAgentConfig.xml configuration file to all the servers in your organization. If you don't deploy the configuration file first and you enable the Scripting ``Agent, all non-Get cmdlets fail when they're run. This example enables the Scripting Agent.

Enable-CmdletExtensionAgent "Scripting Agent"

Дополнительные сведения о синтаксисе и параметрах см. в разделе Enable-CmdletExtensionAgent.For detailed syntax and parameter information, see Enable-CmdletExtensionAgent.

Выключение агента расширения командлетаDisable a cmdlet extension agent

При отключении агента расширения командлета в Exchange 2013 агент отключается на каждом сервере Exchange 2013 в организации. При отключении агент становится недоступным для командлетов. Командлеты больше не смогут использовать этот агент для выполнения дополнительных операций.When you disable a cmdlet extension agent in Exchange 2013, the agent is disabled on every server running Exchange 2013 in the organization. When an agent is disabled, it's not made available to cmdlets. Cmdlets can no longer use the agent to perform additional operations.

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

Перед отключением агента рекомендуется изучить принципы работы агента и влияние отключения агента на работу организации.Before you disable an agent, be sure that you're aware of how the agent works and what impact disabling the agent will have on your organization.

Для отключения агента расширения командлета, используйте командлет Disable-CmdletExtensionAgent . Укажите имя агента, которые необходимо отключить при запуске командлета. В этом примере отключается Scripting Agent.To disable a cmdlet extension agent, use the Disable-CmdletExtensionAgent cmdlet. Specify the name of the agent you want to disable when you run the cmdlet. This example disables the Scripting Agent.

Disable-CmdletExtensionAgent "Scripting Agent"

Дополнительные сведения о синтаксисе и параметрах см. в разделе Disable-CmdletExtensionAgent.For detailed syntax and parameter information, see Disable-CmdletExtensionAgent.

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

Просмотр агентов расширения командлетов позволяет увидеть, какие агенты запускаются первыми, и какие агенты включены в организации Exchange 2013. Дополнительные сведения о конвейере и командлете Format-Table см. в следующих разделах:Viewing cmdlet extension agents enables you to see which agents are run first and which agents are enabled in an Exchange 2013 organization. For more information about pipelining and the Format-Table cmdlet, see the following topics:

В этом примере выводятся сведения обо агента расширения командлета, определенные с помощью командлета Get-CmdletExtensionAgent . В этом примере сведения о Mailbox Permissions Agent возвращаются.This example gets the details of a specific cmdlet extension agent by using the Get-CmdletExtensionAgent cmdlet. In this example, the details of the Mailbox Permissions Agent are returned.

Get-CmdletExtensionAgent "Mailbox Permissions Agent"

В этом примере показано, как получить сведения о нескольких агентах расширения командлета с помощью командлета Get-CmdletExtensionAgent, а затем передать по конвейеру выходные данные в командлет Format-Table. В этом примере отображается список всех агентов расширения командлета в организации, а с помощью командлета Format-Table свойства Name, Enabled и Priority каждого агента отображаются в таблице.This example gets multiple cmdlet extension agents by using the Get-CmdletExtensionAgent cmdlet, and then pipes the output to the Format-Table cmdlet. This example displays a list of all of the cmdlet extension agents in the organization, and by using the Format-Table cmdlet, the Name, Enabled, and Priority properties of each agent are displayed in a table.

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

Дополнительные сведения о синтаксисе и параметрах см. в разделе Get-CmdletExtensionAgent.For detailed syntax and parameter information, see Get-CmdletExtensionAgent.

Изменение приоритета агента расширения командлетаChange the priority of a cmdlet extension agent

Возможность изменения приоритета агента расширения командлета в Exchange 2013 полезен при определенных агент вызов командлета перед другой агент. Это особенно полезен при создании настраиваемых скриптов, которые выполняются в Scripting Agent, и этот сценарий, имеют приоритет перед встроенных агентов. Дополнительные сведения о Scripting Agent, видеть агенты расширения командлета.The ability to change the priority of a cmdlet extension agent in Exchange 2013 is useful when you want a certain agent to be called by a cmdlet before another agent. This is especially useful if you create a custom script that's run in the Scripting Agent, and you want that script to take precedence over a built-in agent. For more information about the Scripting Agent, see Cmdlet extension agents.

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

Изменение приоритета или замена функций встроенного агента являются дополнительными операциями. Убедитесь, что имеете полное представление о производимых изменениях.Changing the priority or replacing the functionality of a built-in agent is an advanced operation. Be sure that you completely understand the changes you're making.

Агенты упорядочены от нуля до максимального числа агентов. Чем ближе агент расположен к нулю, тем выше его приоритет. Агенты с более высоким приоритетом вызываются в первую очередь. Дополнительные сведения о приоритетах агентов см. в разделе Агенты расширения командлета.Agents are ordered from zero to the maximum number of agents. The closer to zero the agent is, the higher the priority of the agent. Agents with a higher priority are called first. For more information about agent priorities, see Cmdlet extension agents.

В этом примере изменяется приоритет агента расширения командлета с помощью командлета Set-CmdletExtensionAgent . В этом примере приоритет Scripting Agent изменяется на 3.This example changes the priority of a cmdlet extension agent by using the Set-CmdletExtensionAgent cmdlet. In this example, the priority of the Scripting Agent is changed to 3.

Set-CmdletExtensionAgent "Scripting Agent" -Priority 3

Дополнительные сведения о синтаксисе и параметрах см. в разделе Set-CmdletExtensionAgent.For detailed syntax and parameter information, see Set-CmdletExtensionAgent.