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


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

 

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

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

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

Синтаксис

Get-TransportRule [-Identity <RuleIdParameter>] [-DomainController <Fqdn>] [-State <Enabled | Disabled>]

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

Командлет Get-TransportRule позволяет просмотреть настройку правил транспорта, которые определены на транспортном сервере-концентраторе или пограничном транспортном сервере. Если выполнить данную команду на сервере «Узловой транспорт», на экран будут выведены все правила транспорта, которые настроены в организации, за исключением правил, настроенных на сервере «Граничный транспорт». Если выполнить данную команду на сервере «Граничный транспорт», на экран будут выведены только правила, которые настроены на локальном сервере «Граничный транспорт».

Сведения о настройке правил транспорта, которые выполняются для сообщений электронной почты в организации Exchange 2007 см. в разделе Командлет Set-TransportRule (версия RTM).

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

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

  • роль администратора Exchange с правами на просмотр.

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

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

Параметры

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Идентификатор

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

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Используйте этот параметр для указания правила транспорта, которое необходимо просмотреть. Введите или идентификатор GUID, или Name -имя правила. Можно пропустить метку параметра Identity.

Состояние

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

Microsoft.Exchange.MessagingPolicies.Rules.RuleState

Применяйте этот параметр для фильтрации результатов выполнения команды Get-TransportRule. Для данного параметра допустимы следующие значения:

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

  • Disabled   Предписывает команде возвращать только правила, которые отключены и которые не применяются к сообщениям электронной почты.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующих примерах представлен синтаксис команды Get-TransportRule. В первом примере возвращается только правило, которое соответствует имени «Блокировать сообщения электронной почты между группами "Продавцы" и "Брокеры"». Результат выполнения команды направляется на вход команды Format-List для отображения подробных сведений о настройке указанного правила транспорта.

Во втором примере возвращается сводный список всех правил транспорта, которые настроены в организации Exchange, если команда выполняется на сервере «Узловой транспорт», или возвращаются правила, настроенные на локальном компьютере, если команда выполняется на сервере «Граничный транспорт».

Дополнительные сведения о конвейеризации см. в разделе Конвейеризация.

Для получения дополнительных сведений о работе с выходными данными команды см. раздел Работа с возвращаемыми данными команды.

Get-TransportRule "Block e-mail messages between Sales and Brokerage Groups" | Format-List
Get-TransportRule