New-SweepRule

Модуль:
Exchange PowerShell

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

Командлет New-SweepRule используется для создания правил очистки в почтовых ящиках. Правила очистки выполняются через определенные интервалы, чтобы поддерживать чистоту папки "Входящие".

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

Синтаксис

Default (По умолчанию) 

New-SweepRule
    [-Name] <String>
    -Provider <String>
    [-Confirm]
    [-DestinationFolder <MailboxFolderIdParameter>]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-ExceptIfFlagged <Boolean>]
    [-ExceptIfPinned <Boolean>]
    [-KeepForDays <Int32>]
    [-KeepLatest <Int32>]
    [-Mailbox <MailboxIdParameter>]
    [-Sender <RecipientIdParameter>]
    [-SourceFolder <MailboxFolderIdParameter>]
    [-SystemCategory <SystemCategoryType>]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

Примеры

Пример 1

New-SweepRule -Name "From Michelle" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender michelle@fabrikam.com -KeepLatest 1

В этом примере создается новое правило очистки с именем "От Мишкина" в почтовом ящике Фелипе Аподака, которое сохраняет последнее сообщение из michelle@fabrikam.com папки "Входящие", а более старые — в папку "Удаленные".

Пример 2

New-SweepRule -Name "From Lila" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender lila@fabrikam.com -KeepForDays 10

В этом примере создается новое правило очистки с именем "From Lila" в почтовом ящике Фелипе Аподака, которое перемещает сообщения lila@fabrikam.com из папки "Входящие" старше 10 дней в папку "Удаленные".

Пример 3

New-SweepRule -Name "From Jeff" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender jeffm@fabrikam.com -SourceFolder "Felipe:\Sent Items" -KeepForDays 10

В этом примере создается новое правило очистки с именем "От Джеффа" в почтовом ящике Фелипе Аподаки, которое перемещает сообщения jeffm@fabrikam.com из папки "Отправленные" старше 10 дней в папку "Удаленные".

Параметры

-Confirm

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DestinationFolder

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр DestinationFolder определяет действие для правила очистки, которое перемещает сообщения в указанную папку. Используется следующий синтаксис: MailboxID:\ParentFolder[\SubFolder].

В качестве значения MailboxIDможно использовать любое значение, которое однозначно определяет почтовый ящик. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Примеры значений для этого параметра: john@contoso.com:\Unimportant или John:\Inbox\Misc. Значение по умолчанию — MailboxID:\Deleted Items.

Свойства параметров

Тип:MailboxFolderIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainController

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:Fqdn
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Enabled

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

  • $true: правило включено. Это значение используется по умолчанию.
  • $false. Правило отключено.

Создав правило, вы можете включать и отключать его с помощью командлетов Enable-SweepRule и Disable-SweepRule.

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExceptIfFlagged

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Параметр ExceptIfFlagged задает исключение для правила очистки, позволяющего найти сообщения с примененным флагом. Допустимые значения:

  • $true. Действие правила не применяется к сообщениям, к которым применен флаг.
  • $false. Исключение не используется.

Типичные значения флагов сообщений:

  • Любой
  • Звонок
  • DoNotForward
  • Дальнейшие действия
  • ДляВашейИнформации
  • Переслать
  • NoResponseNeeded
  • Чтение
  • Ответить
  • Ответить Всем
  • Проверка

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExceptIfPinned

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Параметр PinMessage задает исключение для правила очистки, позволяющего найти закрепленные сообщения. Допустимые значения:

  • $true. Действие правила не применяется к сообщениям, закрепленным в верхней части папки "Входящие".
  • $false: исключение не используется.

Свойства параметров

Тип:Boolean
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-KeepForDays

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр KeepForDays определяет действие для правила очистки, которое указывает количество дней, в течение которых хранятся сообщения, удовлетворяющие условиям правила. По прошествии указанного количества дней сообщения перемещаются в расположение, указанное параметром DestinationFolder (по умолчанию это папка "Удаленные").

Этот параметр нельзя использовать с параметром KeepLast, и правило очистки должно содержать значение параметра KeepForDays или KeepLast.

Свойства параметров

Тип:Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-KeepLatest

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр KeepLatest определяет действие для правила очистки, которое указывает количество сообщений, которые должны соответствовать условиям правила. После превышения количества сообщений самые старые сообщения перемещаются в расположение, указанное параметром DestinationFolder (по умолчанию это папка "Удаленные").

Этот параметр нельзя использовать с параметром KeepForDays, а правило очистки должно содержать значение параметра KeepForDays или KeepLast.

Свойства параметров

Тип:Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Mailbox

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр Mailbox указывает почтовый ящик, в котором требуется создать правило очистки. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Свойства параметров

Тип:MailboxIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр Name задает имя правила очистки. Если значение содержит пробелы, его необходимо заключить в кавычки.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Provider

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Для правил очистки, созданных в Outlook в Интернете, значением по умолчанию является Exchange16.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Sender

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID

Для внешних отправителей используйте их электронные адреса.

Свойства параметров

Тип:RecipientIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SourceFolder

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр SourceFolder определяет условие для правила очистки, которое ищет сообщения в указанной папке. Используется следующий синтаксис: MailboxID:\ParentFolder[\SubFolder].

В качестве значения MailboxIDможно использовать любое значение, которое однозначно определяет почтовый ящик. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Примеры значений для этого параметра: john@contoso.com:\Marketing или John:\Inbox\Reports. Значение по умолчанию — MailboxID:\Inbox.

Свойства параметров

Тип:MailboxFolderIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SystemCategory

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Параметр SystemCategory задает условие для правила очистки, которое ищет сообщения с указанной системной категорией. Системные категории доступны для всех почтовых ящиков организации. Допустимые значения:

  • NotDefined
  • Счета
  • Документ
  • DocumentPlus
  • Событие
  • Семейство
  • File
  • Тестируемая возможность
  • ОтКонтакт
  • Важно!
  • Просмотр в реальном времени
  • Жилье
  • MailingList
  • Информационный бюллетень
  • Photo
  • Покупка
  • RentalCar
  • РесторанБронирование
  • ПенсионерПовышение
  • УведомлениеДоставкиУведомления
  • Шоппинг
  • SocialUpdate
  • Путешествия
  • Видео

Свойства параметров

Тип:SystemCategoryType
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.