Set-TransportAgent
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2007-07-27
Командлет Set-TransportAgent служит для изменения агента транспорта на компьютере с установленной ролью пограничного транспортного сервера или транспортного сервера-концентратора в организации Microsoft Exchange Server 2007.
Синтаксис
Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]
Подробное описание
Командлет Set-TransportAgent служит для изменения агента транспорта на пограничном транспортном сервере или транспортном сервере-концентраторе.
Для выполнения командлета Set-TransportAgent используемой учетной записи необходимо делегировать следующее:
- роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.
Для запуска командлета Set-TransportAgent на компьютере с установленной ролью пограничного транспортного сервера необходимо войти в систему с помощью учетной записи, являющейся членом локальной группы администраторов этого компьютера.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
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 -Identity "Antivirus for Exchange" -Priority 3