Get-TransportRule
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Командлет Get-TransportRule используется для просмотра правил транспорта (правил для потока обработки почты) в организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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.)"
В локальной среде Exchange этот пример возвращает сводный список правил, которые применяют политику защиты от потери данных с именем PII (США) в организации.
Пример 4
Get-TransportRule | Where {$_.DlpPolicy -ne $null}
В локальной среде Exchange этот пример возвращает сводный список всех правил, которые применяют политики защиты от потери данных в организации.
Параметры
-DlpPolicy
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Примечание. Этот параметр работает только в локальной среде Exchange.
Параметр DlpPolicy фильтрует результаты по имени указанной политики защиты от потери данных (DLP). Если значение содержит пробелы, его необходимо заключить в кавычки (").
Политики защиты от потери данных, настроенные в организации, помогают предотвращать непредумышленную утечку важной информации. Каждая политика защиты от потери данных применяется с помощью набора правил транспорта.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.
Свойства параметров
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExcludeConditionActionDetails
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр доступен только в облачной службе.
Параметр ExcludeConditionActionDetails указывает, следует ли скрывать определенные сведения из результатов. Допустимые значения:
- $true. Свойства Description, Conditions и Actions, а также все настроенные значения условий, исключений и свойств действий пусты.
- $false: свойства или значения свойств не скрыты. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Filter
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Filter фильтрует результаты с помощью OPATH. Этот параметр выполняет поиск свойства Description, которое включает условия, исключения, действия и связанные значения правила транспорта.
Синтаксис этого параметра: "Description -like 'Text*'". Например, "Description -like '192.168.1.1*'".
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр Identity определяет правило, которое необходимо просмотреть. Можно использовать любое значение, уникальным образом идентифицирующее правило. Пример:
- имя;
- различающееся имя (DN);
- GUID
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | RuleIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-State
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков
Параметр State фильтрует результаты по включенным или отключенным правилам. Допустимые значения:
- Enabled: в результатах возвращаются только включенные правила.
- Disabled: в результатах возвращаются только отключенные правила.
Если этот параметр не используется, команда возвращает все правила: как включенные, так и отключенные.
Свойства параметров
| Тип: | RuleState |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.