New-TransportRule

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

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

Синтаксис

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

Actions

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

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

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

Name

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

System.String

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

Comments

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

System.String

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

Conditions

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

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

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Enabled

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

System.Boolean

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

Exceptions

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

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

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

Priority

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

System.Int32

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

TemplateInstance

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

System.Management.Automation.PSObject

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

  • между списком рассылки и списком рассылки   Первое значение свойства предиката для этого условия — группа рассылки «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)