Get-TransportRule

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

Командлет Get-TransportRule используется для просмотра правил транспорта (правил для потока обработки почты) в организации.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-TransportRule
   [[-Identity] <RuleIdParameter>]
   [-DomainController <Fqdn>]
   [-State <RuleState>]
   [-DlpPolicy <String>]
   [-ExcludeConditionActionDetails <Boolean>]
   [-Filter <String>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

На серверах почтовых ящиков этот командлет возвращает все правила в организации Exchange, которые хранятся в Active Directory. На пограничном транспортном сервере этот командлет возвращает только правила, настроенные на локальном сервере.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-TransportRule

В этом примере возвращается сводный список всех правил в организации.

Пример 2

Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-List

В этом примере возвращаются подробные сведения о правиле под названием "Ethical Wall - Sales and Brokerage Departments".

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

Пример 3

Get-TransportRule -DlpPolicy "PII (U.S.)"

В этом примере возвращается сводный список правил, используемых для применения политики защиты от потери данных PII (U.S.) в организации.

Пример 4

Get-TransportRule | Where {$_.DlpPolicy -ne $null}

В этом примере возвращается сводный список всех правил, используемых для применения политик защиты от потери данных в организации.

Параметры

-DlpPolicy

Параметр DlpPolicy фильтрует результаты по имени указанной политики защиты от потери данных. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExcludeConditionActionDetails

Этот параметр доступен только в облачной службе.

Параметр ExcludeConditionActionDetails указывает, следует ли скрывать определенные сведения из результатов. Допустимые значения:

$true. Свойства Description, Conditions и Actions, а также все настроенные значения условий, исключений и свойств действий пусты.
$false: свойства или значения свойств не скрыты. Это значение используется по умолчанию.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Filter

Параметр Filter фильтрует результаты с помощью OPATH. Этот параметр выполняет поиск свойства Description, которое включает условия, исключения, действия и связанные значения правила транспорта.

Этот параметр использует синтаксис "Description -like 'Text*'". Например, "Description -like '192.168.1.1*'".

Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

Параметр Identity определяет правило, которое необходимо просмотреть. Можно использовать любое значение, уникальным образом идентифицирующее правило. Пример:

имя;
различающееся имя (DN);
GUID

Type:	RuleIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

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

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-State

Параметр State фильтрует результаты по включенным или отключенным правилам. Допустимые значения:

Enabled: в результатах возвращаются только включенные правила.
Disabled: в результатах возвращаются только отключенные правила.

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

Type:	RuleState
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.