Командлет Install-TransportAgent используется для регистрации агента транспорта на компьютере с ролью пограничного транспортного сервера или ролью транспортного сервера-концентратора, установленной в организации Microsoft Exchange Server 2007.

Синтаксис


Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр	Обязательный	Тип	Описание
AssemblyPath	Обязательный	System.String	Этот параметр указывает местоположение сборки Microsoft .NET агента транспорта. Не допускается использовать пути файлов с использованием универсальных имен (UNC).
Name	Обязательный	System.String	Этот параметр задает отображаемое имя устанавливаемого агента транспорта. Длина имени не должна превышать 64 символов.
TransportAgentFactory	Обязательный	System.String	Этот параметр задает тип класса Microsoft .NET фабрики агента транспорта. Разработчик устанавливаемого агента транспорта предоставляет фабрику агента транспорта и соответствующие сведения. Дополнительные сведения см. в документации, предоставленной разработчиком агента транспорта.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с установленной ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет чтение и запись только для локального экземпляра ADAM.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

Подробное описание

Командлет Install-TransportAgent используется для регистрации агента транспорта при работе на пограничном транспортном сервере или на транспортном сервере-концентраторе.

Внимание!
Агенты транспорта имеют полный доступ ко всем сообщениям электронной почты, с которыми они сталкиваются. Приложение Exchange не накладывает ограничений на поведение агентов транспорта. Нестабильные агенты транспорта или с недостатками в системе безопасности могут повлиять на стабильность и безопасность Exchange. Поэтому устанавливать необходимо только те агенты транспорта, которые заслуживают полного доверия и были испытаны в лабораторной среде.

Внимание!

Агенты транспорта имеют полный доступ ко всем сообщениям электронной почты, с которыми они сталкиваются. Приложение Exchange не накладывает ограничений на поведение агентов транспорта. Нестабильные агенты транспорта или с недостатками в системе безопасности могут повлиять на стабильность и безопасность Exchange. Поэтому устанавливать необходимо только те агенты транспорта, которые заслуживают полного доверия и были испытаны в лабораторной среде.

Для выполнения командлета Install-TransportAgent используемой учетной записи необходимо делегировать следующее:

роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить командлет Install-TransportAgent на компьютере, на котором установлена роль пограничного транспортного сервера, необходимо войти в систему под учетной записью, являющейся членом локальной группы администраторов на этом компьютере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка	Описание

Исключения

Исключения	Описание

Пример

В следующем примере показывается, как установить воображаемое антивирусное приложение на сервере «Граничный транспорт» или на сервере «Узловой транспорт».

	Копировать код
Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"

Копировать код

Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"