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

Синтаксис

Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательный Тип Описание

Identity

Обязательный

System.String

С помощью этого параметра можно указать отображаемое имя агента транспорта, которое нужно изменить. Длина имени не может превышать 64 знаков.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с установленной ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет чтение и запись только для локального экземпляра ADAM.

Priority

Необязательный

System.Nullable

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

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

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

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

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

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

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

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

В приведенном ниже примере показано, как будет изменен приоритет вымышленного антивирусного агента.

Копировать код
Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3