Поделиться через


Командлет New-TransportRule (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-08

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

Синтаксис

New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>]

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

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

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

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

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

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

Дополнительные сведения о создании нового правила транспорта см. в разделе Создание правила транспорта.

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

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

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

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

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

Параметры

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

Действия

Обязательность

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

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

Имя

Обязательность

System.String

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

Комментарии

Дополнительно

System.String

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

Условия

Дополнительно

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

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

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

Включен

Дополнительно

System.Boolean

Используйте этот параметр, чтобы указать, включено или отключено правило транспорта при его создании. Значение по умолчанию: $true.

Исключения

Дополнительно

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

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

Priority

Дополнительно

System.Int32

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

TemplateInstance

Дополнительно

System.Management.Automation.PSObject

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере показано, как создать правило транспорта на пограничном транспортном сервере.

В этом правиле применяются следующие условия:

  • между списком рассылки и списком рассылки   Первое значение свойства предиката для этого условия — группа рассылки «Sales Group». Значение второго свойства предиката для этого условия — группа рассылки «Brokerage Group».

Применяются следующие исключения:

  • с шаблонами текста в теме — значение для этого исключения — «Press Release» или «Corporate Communication».

  • от людей   Значениями этого исключения являются «Ted Bremer» и «Pilar Ackerman».

Следующие действия будут применены к любым сообщениям, которые будут соответствовать вышеприведенным условиям, но не будут соответствовать исключениям «с шаблонами текста в теме» и «от людей».

  • отправка отраженного фрагмента сообщения отправителю   Значением этого действия является сообщение «E-mail messages sent between the Sales department and the Brokerage department are prohibited».

  • регистрация события для сообщения   Значением этого действия является сообщение «A prohibited e-mail message has been rejected».

$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)