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