Get-InboxRule
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Get-InboxRule для просмотра свойств правила для папки "Входящие". Правила для папки входящих сообщений используются для обработки сообщений в папке "Входящие" согласно указанным условиям, а также для выполнения ряда действий, таких как перемещение сообщения в указанную папку или удаление сообщения.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-InboxRule
[[-Identity] <InboxRuleIdParameter>]
[-BypassScopeCheck]
[-DescriptionTimeFormat <String>]
[-DescriptionTimeZone <ExTimeZoneValue>]
[-DomainController <Fqdn>]
[-IncludeHidden]
[-Mailbox <MailboxIdParameter>]
[-SweepRules]
[<CommonParameters>] Описание
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примечание. Этот командлет не работает для членов группы ролей управления View-Only организацией в Exchange Online или роли "Глобальный читатель" в Azure Active Directory.
Примеры
Пример 1
Get-InboxRule -Mailbox Joe@Contoso.comВ этом примере извлекаются все правила папки "Входящие" для почтового ящика Joe@Contoso.com.
Пример 2
Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -DescriptionTimeFormat "mm/dd/yyyy" -DescriptionTimeZone "Pacific Standard Time"В этом примере извлекается правило для папки "Входящие" ReceivedLastYear из почтового ящика joe@contoso.com , для которого был задан параметр ReceivedBeforeDate при создании правила. Параметры DescriptionTimeFormat и DescriptionTimeZone используются в примере для указания формата значений времени и часового пояса, используемых в свойстве правила Description.
Параметры
-BypassScopeCheck
Параметр BypassScopeCheck указывает, следует ли пропускать проверку области для пользователя, выполняющего команду. Указывать значение для этого параметра необязательно.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DescriptionTimeFormat
Параметр DescriptionTimeFormat задает формат значений времени в описании правила. Например:
мм/дд/гггг, где мм — это 2-значный месяц, дд — 2-значный день, а гггг — 4-значный год.
| Type: | String |
| 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 |
-DescriptionTimeZone
Параметр DescriptionTimeZone указывает часовой пояс, используемый для значений времени в описании правила.
$false. Правило или политика отключена.
Чтобы просмотреть доступные значения, выполните следующую команду: $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display.
Если значение содержит пробелы, его необходимо заключить в кавычки ("). Значение по умолчанию — это параметр часового пояса сервера Exchange Server.
| Type: | ExTimeZoneValue |
| 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 |
-DomainController
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
| 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 |
-Identity
Параметр Identity указывает правило папки "Входящие", которое требуется просмотреть. Можно использовать любое значение, уникальным образом идентифицирующее правило. Пример:
- Имя
- Свойство RuleIdentity (например, 16752869479666417665).
- Exchange Online:
MailboxAlias\RuleIdentity(например,rzaher\16752869479666417665). - Локальный Exchange:
MailboxCanonicalName\RuleIdentity(например,contoso.com/Users/Rick Zaher\16752869479666417665).
| Type: | InboxRuleIdParameter |
| 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 |
-IncludeHidden
Параметр IncludeHidden указывает, следует ли включать скрытые правила папки "Входящие" в результаты. Указывать значение для этого параметра необязательно.
| Type: | SwitchParameter |
| 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 |
-Mailbox
Параметр Mailbox определяет почтовый ящик, который содержит правило для папки "Входящие". Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
| Type: | MailboxIdParameter |
| 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 |
-SweepRules
Этот параметр доступен только в локальной среде Exchange.
Параметр SweepRules указывает, следует ли возвращать в результатах только правила очистки. Для этого переключателя не требуется указывать значение.
Правила очистки выполняются через регулярные интервалы, чтобы обеспечить чистоту папки "Входящие".
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по