New-QuarantinePolicy
Этот командлет доступен только в облачной службе.
Используйте командлет New-QuarantinePolicy для создания политик карантина в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
New-QuarantinePolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantinePolicyType <QuarantinePolicyType>]
[-QuarantineRetentionDays <Int32>]
[<CommonParameters>]
Описание
Политики карантина определяют, что разрешено делать с сообщениями, помещенными в карантин, на основе причины, по которой сообщение было помещено в карантин (для поддерживаемых функций), и параметров уведомления о карантине. Дополнительные сведения см. в статье Политики карантина.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0
В этом примере создается новая политика карантина с именем ContosoTag с теми же разрешениями, что и у группы предустановленных разрешений "Нет доступа".
Чтобы назначить разрешения на ограниченный доступ, используйте значение 27. Чтобы назначить разрешения на полный доступ, используйте значение 23.
Параметры
-AdminDisplayName
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр AdminDisplayName указывает описание политики карантина. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminNotificationFrequencyInDays
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminNotificationLanguage
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | EsnLanguage |
| Значение по умолчанию: | None |
| Допустимые значения: | Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminNotificationsEnabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminQuarantinePermissionsList
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CustomDisclaimer
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserQuarantinePermissions
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Примечание. Для настройки разрешений в политиках карантина рекомендуется использовать параметр EndUserQuarantinePermissionsValue.
EndUserQuarantinePermissions указывает разрешения конечных пользователей для политики карантина с помощью переменной из выходных данных команды New-QuarantinePermissions или Set-QuarantinePermissions.
Например, выполните следующую команду, чтобы сохранить необходимые разрешения в переменной: $Perms = New-QuarantinePermissions <permissions>. В том же сеансе PowerShell используйте значение $Perms для этого параметра.
Свойства параметров
| Тип: | QuarantinePermissions |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserQuarantinePermissionsValue
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EndUserQuarantinePermissionsValue указывает разрешения конечных пользователей для политики карантина.
Этот параметр использует десятичное значение, преобразованное из двоичного значения. Двоичное значение соответствует списку доступных разрешений в определенном порядке. Для каждого разрешения значение 1 равно True, а значение 0 равно False. Обязательный порядок описан в следующем списке от наибольшего (1000000 или 128) до наименьшего (00000001 или 1):
- PermissionToViewHeader: значение 0 не скрывает действие просмотра заголовка сообщения в карантине. Если сообщение отображается в карантине, для сообщения всегда доступно действие.
- PermissionToDownload: это разрешение не используется (значение 0 или 1 ничего не дает).
- PermissionToAllowSender
- PermissionToBlockSender
- PermissionToRequestRelease: не устанавливать для этого разрешения и PermissionToRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или установите оба значения равными 0.
- PermissionToRelease: не устанавливайте для этого разрешения и PermissionToRequestRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или установите оба значения равными 0. Это разрешение не распространяется на сообщения, помещенные на карантин как вредоносные программы или фишинговые сообщения с высоким уровнем доверия. Если политика карантина предоставляет пользователям это разрешение, им разрешается запрашивать освобождение от своих помещенных в карантин вредоносных программ или фишинговых сообщений с высоким уровнем доверия, как если бы вместо этого был выбран параметр PermissionToRequestRelease.
- PermissionToPreview
- РазрешениеВУдаление
Значения предварительно настроенных групп разрешений конечных пользователей описаны в следующем списке.
- Нет доступа: Binary = 00000000, поэтому используйте десятичное значение 0.
- Ограниченный доступ: двоичный = 00101011, поэтому используйте десятичное значение 43.
- Полный доступ: Binary = 00100111, поэтому используйте десятичное значение 39.
Для настраиваемых разрешений получите двоичное значение, соответствующее нужным разрешениям. Преобразуйте двоичное значение в десятичное. Не используйте двоичное значение для этого параметра.
Примечание: Если значение этого параметра равно 0 (доступ отсутствует), а значение параметра ESNEnabled равно $true, пользователи могут просматривать свои сообщения в карантине, но единственное доступное действие для сообщений — это просмотр заголовка сообщения.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationCustomFromAddress
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
EndUserSpamNotificationCustomFromAddress указывает адрес электронной почты существующего внутреннего отправителя, который используется в качестве отправителя для уведомлений о карантине.
Если этот параметр не используется, отправителем по умолчанию является quarantine@messaging.microsoft.com.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationFrequency
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EndUserSpamNotificationFrequency определяет, как часто пользователям отправляются уведомления о карантине. Допустимые значения:
- 04:00:00 (4 часа)
- 1.00:00:00 (1 день)
- 7.00:00:00 (7 дней)
Свойства параметров
| Тип: | TimeSpan |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationFrequencyInDays
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationLanguage
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | EsnLanguage |
| Значение по умолчанию: | None |
| Допустимые значения: | Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EsnCustomSubject
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EsnCustomSubject указывает текст, используемый в поле Subject уведомлений о карантине.
Вы можете указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст отправителя. Убедитесь, что соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName приведены в одинаковом порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду со следующим синтаксисом: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
Свойства параметров
| Тип: | MultiValuedProperty |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | MultiValuedProperty |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ESNEnabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ESNEnabled указывает, следует ли включить уведомления о карантине (ранее известные как уведомления о спаме конечного пользователя) для политики. Допустимые значения:
- $true. Уведомления о карантине включены.
- $false: уведомления о карантине отключены. Пользователь может получить доступ к сообщениям, помещенным в карантин, только в карантине, а не в Уведомления по электронной почте. Это значение используется по умолчанию.
Примечание. Если значение этого параметра равно $true, а значение параметра EndUserQuarantinePermissionsValue равно 0 (доступ отсутствует, если отключены все разрешения), пользователи могут просматривать свои сообщения в карантине, но единственное доступное действие для этих сообщений — просмотр заголовка сообщения.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeMessagesFromBlockedSenderAddress
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeMessagesFromBlockedSenderAddress указывает, следует ли отправлять уведомления о карантине для сообщений, помещенных в карантин, с заблокированных адресов отправителей. Допустимые значения:
- $true. Получатели получают уведомления о карантине для затронутых сообщений от заблокированных отправителей.
- $false. Получатели не получают уведомления о карантине для затронутых сообщений от заблокированных отправителей. Это значение используется по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiLanguageCustomDisclaimer
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiLanguageSenderName
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiLanguageSetting
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Name указывает уникальное имя политики карантина. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OrganizationBrandingEnabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-QuarantinePolicyType
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | QuarantinePolicyType |
| Значение по умолчанию: | None |
| Допустимые значения: | QuarantinePolicy, GlobalQuarantinePolicy |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-QuarantineRetentionDays
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | 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.