Командлет 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 |
Используйте этот параметр, чтобы указать, включено или отключено правило транспорта при его создании. Значение по умолчанию: |
Исключения |
Дополнительно |
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)