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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminNotificationFrequencyInDays
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminNotificationLanguage
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | EsnLanguage |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AdminQuarantinePermissionsList
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CustomDisclaimer
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Fqdn |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserQuarantinePermissionsValue
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EndUserQuarantinePermissionsValue указывает разрешения конечного пользователя для политики карантина.
Этот параметр использует десятичное значение, преобразованное из двоичного значения. Двоичное значение соответствует списку доступных разрешений в определенном порядке. Для каждого разрешения значение 1 равно True, а значение 0 — false. Требуемый порядок описан в следующем списке с самого высокого (10000000 или 128) до самого низкого (00000001 или 1):
- PermissionToViewHeader: значение 0 не скрывает действие Просмотр заголовка сообщения в карантине. Если сообщение отображается в карантине, действие всегда доступно для сообщения.
- PermissionToDownload: это разрешение не используется (значение 0 или 1 ничего не делает).
- PermissionToAllowSender
- PermissionToBlockSender
- PermissionToRequestRelease: не устанавливайте для этого разрешения и PermissionToRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или задайте для обоих значений значение 0.
- PermissionToRelease: не устанавливайте для этого разрешения и PermissionToRequestRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или задайте для обоих значений значение 0. Это разрешение не предоставляется для сообщений, которые были помещены в карантин как вредоносные программы или фишинг с высокой степенью достоверности. Если политика карантина предоставляет пользователям это разрешение, пользователи могут запрашивать выпуск их помещенных в карантин вредоносных программ или фишинговых сообщений с высокой степенью достоверности, как если бы вместо этого было выбрано PermissionToRequestRelease.
- PermissionToPreview
- PermissionToDelete
Значения для предустановленных групп разрешений конечных пользователей описаны в следующем списке:
- Нет доступа: Binary = 0000000, поэтому используйте десятичное значение 0.
- Ограниченный доступ: Binary = 00101011, поэтому используйте десятичное значение 43.
- Полный доступ: Binary = 00100111, поэтому используйте десятичное значение 39.
Для пользовательских разрешений получите двоичное значение, соответствующее нужным разрешениям. Преобразуйте двоичное значение в десятичное значение для использования. Не используйте двоичное значение для этого параметра.
Примечание. Если значение этого параметра равно 0 (нет доступа), а значение параметра ESNEnabled равно $true, пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationCustomFromAddress
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
EndUserSpamNotificationCustomFromAddress указывает адрес электронной почты существующего внутреннего отправителя, который будет использоваться в качестве отправителя для уведомлений о карантине.
Если этот параметр не используется, отправитель по умолчанию — [email protected].
Свойства параметров
| Тип: | String |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationFrequencyInDays
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndUserSpamNotificationLanguage
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | EsnLanguage |
| Default value: | 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 указывает текст, используемый в поле Тема уведомлений о карантине.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | MultiValuedProperty |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ESNEnabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ESNEnabled указывает, следует ли включать уведомления о карантине (прежнее название — уведомления о нежелательной почте конечных пользователей) для политики. Допустимые значения:
- $true. Уведомления о карантине включены.
- $false. Уведомления о карантине отключены. Пользователь может получить доступ к сообщениям, помещенным в карантин, только в карантине, а не в Уведомления по электронной почте. Это значение является значением по умолчанию.
Примечание. Если значение этого параметра равно $true, а значение параметра EndUserQuarantinePermissionsValue равно 0 (нет доступа, где отключены все разрешения), пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeMessagesFromBlockedSenderAddress
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeMessagesFromBlockedSenderAddress указывает, следует ли отправлять уведомления о карантине для сообщений, помещенных в карантин, с заблокированных адресов отправителей. Допустимые значения:
- $true: получатели получают уведомления о карантине для затронутых сообщений от заблокированных отправителей.
- $false: получатели не получают уведомления о карантине для затронутых сообщений от заблокированных отправителей. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiLanguageCustomDisclaimer
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiLanguageSenderName
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiLanguageSetting
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Name задает уникальное имя для политики карантина. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OrganizationBrandingEnabled
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-QuarantinePolicyType
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | QuarantinePolicyType |
| Default value: | None |
| Допустимые значения: | QuarantinePolicy, GlobalQuarantinePolicy |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-QuarantineRetentionDays
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| 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.