Командлет 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 -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>]]

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)