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

Синтаксис

Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Identity

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Используйте этот параметр, чтобы указать идентификатор GUID правила транспорта или имя правила, которые были настроены администратором при создании правила.

Actions

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[]

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

Comments

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

System.String

Используйте этот параметр для добавления информативных комментариев в правило транспорта, например назначения правила или порядка его изменения со временем. Длина комментария не должна превышать 512 знаков.

Conditions

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[]

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Exceptions

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[]

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

Instance

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule

Используйте этот параметр, чтобы передать весь объект в команду для обработки. Этот параметр главным образом используется в сценариях, в которых весь объект должен быть передан команде.

Name

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

System.String

Используйте этот параметр для указания отображаемого имени создаваемого правила транспорта. Длина имени не должна превышать 64 знаков.

Priority

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

System.Int32

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Каждое условие и исключение должно использовать поддерживаемый предикат правила транспорта. Каждый предикат содержит хотя бы одно условие и значения, по которым проверяется условие.

Список поддерживаемых предикатов правил транспорта см. в разделе Предикаты правил транспорта.

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

Список поддерживаемых действий правил см. в разделе Действия правил транспорта.

Подробные сведения об изменении существующего правила транспорта см. в разделе Инструкции по изменению правила транспорта.

Сведения об агенте правил транспорта см. в разделе Обзор правил транспорта.

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

  • роль администратора организации Exchange.

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

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

Это правило будет изменено для применения следующего условия:

  • от члена из списка рассылки — значение для этого условия равно группе рассылки «Группа продаж».

Копировать код
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)