Командлет Set-TransportRule применяется для изменения существующего правила транспорта, которое используется агентом правил транспорта при обработке сообщений электронной почты, проходящих через компьютер с установленной ролью транспортного сервера-концентратора или ролью пограничного транспортного сервера.
Синтаксис
Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] |
Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] |
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Используйте этот параметр, чтобы указать идентификатор GUID правила транспорта или имя правила, которые были настроены администратором при создании правила. |
Действия |
Дополнительно |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
Используйте этот параметр для указания действий, которые применяются правилом транспорта к сообщению электронной почты, если соблюдаются все условия и если отсутствуют действующие исключения. Для каждого правила должно быть указано хотя бы одно действие. |
Комментарии |
Дополнительно |
System.String |
Используйте этот параметр для добавления информативных комментариев в правило транспорта, например назначения правила или порядка его изменения со временем. Длина комментария не должна превышать 512 символов. |
Условия |
Дополнительно |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Используйте этот параметр для указания условий, которые применяются правилом транспорта к сообщениям электронной почты, передаваемым агенту правил транспорта. Когда условие не настроено для правила, правило применяется ко всем сообщениям, если отсутствуют действующие исключения. |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя (FQDN) контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с установленной ролью пограничного транспортного сервера. Роль сервера «Граничный транспорт» выполняет запись только на локальные экземпляры ADAM (Active Directory Application Mode). |
Исключения |
Дополнительно |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Используйте этот параметр для указания исключений, которые применяются правилом транспорта к сообщениям электронной почты. Если сообщение соответствует какому-либо исключению, никакие действия, указанные для этого правила, не применяются к сообщению. |
Instance |
Дополнительно |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule |
Используйте этот параметр, чтобы передать весь объект в команду для обработки. Этот параметр главным образом используется в сценариях, в которых весь объект должен быть передан команде. |
Имя |
Дополнительно |
System.String |
Используйте этот параметр для указания отображаемого имени создаваемого правила транспорта. Длина имени не должна превышать 64 знака. |
Priority |
Дополнительно |
System.Int32 |
Используйте этот параметр для указания порядка, в котором применяются правила транспорта. Если изменить приоритет правила, положение правила в списке правил изменяется в соответствии с указанным приоритетом, при этом агент правил транспорта увеличивает приоритеты всех правил, имеющих большее значение приоритета, чем у обрабатываемого правила. Правила с меньшим значением приоритета обрабатываются вначале. Значение этого параметра должно быть больше или равно 0. |
Подробное описание
Командлет Set-TransportRule позволяет изменять существующее правило транспорта, которое используется агентом правил транспорта при обработке сообщений электронной почты, проходящих через транспортный сервер-концентратор или пограничный транспортный сервер.
Каждое условие и исключение должно использовать поддерживаемый предикат правила транспорта. Каждый предикат содержит хотя бы одно условие и значения, по которым проверяется условие.
Список поддерживаемых предикатов правил транспорта см. в разделе Предикаты правил транспорта.
Каждое действие должно использовать поддерживаемое действие правила транспорта. Каждое действие содержит хотя бы одно действие и значения, которые используются действием для выполнения его задачи.
Список поддерживаемых действий правил см. в разделе Действия правил транспорта.
Подробные сведения об изменении существующего правила транспорта см. в разделе Инструкции по изменению правила транспорта.
Сведения об агентах правил транспорта см. в разделе Обзор правил транспорта.
Для выполнения командлета Set-TransportRule используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Чтобы выполнить командлет Set-TransportRule на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с помощью учетной записи, являющейся членом локальной группы администраторов этого компьютера.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Пример
Ниже приводится полный пример, показывающий, как изменить существующее правило транспорта на сервере «Узловой транспорт». Этот пример показывает, как можно изменить условия для правила транспорта без воздействия на исключения и действия для того же правила.
Это правило будет изменено для применения следующего условия:
- от члена из списка рассылки — значение для этого условия
равно группе рассылки «Группа продаж».
Копировать код | |
---|---|
$Condition = Get-TransportRulePredicate FromMemberOf $Condition.Addresses = @((Get-DistributionGroup "Sales Group")) Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition) |