Set-QuarantinePolicy
Этот командлет доступен только в облачной службе.
Используйте командлет Set-QuarantinePolicy для изменения политик карантина в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-QuarantinePolicy
[-Identity] <QuarantineTagIdParameter>
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-Confirm]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IgnoreDehydratedFlag]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantineRetentionDays <Int32>]
[-WhatIf]
[<CommonParameters>]
Описание
Вы не можете изменить встроенные политики карантина с именами AdminOnlyAccessPolicy, DefaultFullAccessPolicy или DefaultFullAccessWithNotificationPolicy.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1
В этом примере настраиваются разрешения в политике карантина с именем CustomAccess, которая позволяет пользователям удалять только сообщения, помещенные в карантин.
Пример 2
Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息,请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00
В этом примере изменяются глобальные параметры для уведомлений о карантине (ранее известные как параметры уведомлений о нежелательной почте для конечных пользователей):
- Уведомления о карантине настраиваются для английского, китайского и французского языков. Дополнительные кавычки требуются во французском значении MultiLanguageCustomDisclaimer в качестве escape-символов для символов кавычки в тексте.
- Существующий пользователь aashutosh@contso.onmicrosoft.com используется в качестве отправителя уведомления о карантине.
- Ранее настроенный пользовательский логотип заменяет логотип Майкрософт по умолчанию.
- Частота уведомлений о карантине изменяется до 4 часов.
Параметры
-AdminNotificationFrequencyInDays
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-AdminNotificationLanguage
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | EsnLanguage |
Допустимые значения: | 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 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-AdminNotificationsEnabled
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-AdminQuarantinePermissionsList
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Для этих командлетов вы можете пропустить запрос подтверждения, используя точный синтаксис: -Confirm:$false.
- Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-CustomDisclaimer
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-DomainController
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | Fqdn |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissions
Примечание. Чтобы задать разрешения в политиках карантина, рекомендуется использовать параметр EndUserQuarantinePermissionsValue.
EndUserQuarantinePermissions задает разрешения конечного пользователя для политики карантина с помощью переменной из выходных данных команды New-QuarantinePermissions или Set-QuarantinePermissions.
Например, выполните следующую команду, чтобы сохранить необходимые разрешения в переменной: $Perms = New-QuarantinePermissions <permissions>
. В том же сеансе PowerShell используйте значение $Perms
для этого параметра.
Тип: | QuarantinePermissions |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissionsValue
Параметр 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 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationCustomFromAddress
EndUserSpamNotificationCustomFromAddress указывает адрес электронной почты существующего внутреннего отправителя, который будет использоваться в качестве отправителя для уведомлений о карантине. Чтобы задать для этого параметра адрес quarantine@messaging.microsoft.comэлектронной почты по умолчанию, используйте значение $null.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequency
Параметр EndUserSpamNotificationFrequency определяет частоту отправки уведомлений о карантине пользователям. Допустимые значения:
- 04:00:00 (4 часа)
- 1.00:00:00 (1 день)
- 7.00:00:00 (7 дней)
Тип: | TimeSpan |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequencyInDays
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationLanguage
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | EsnLanguage |
Допустимые значения: | 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 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-EsnCustomSubject
Параметр EsnCustomSubject указывает текст, используемый в поле Тема уведомлений о карантине.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN')
. Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
.
Тип: | MultiValuedProperty |
Aliases: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-ESNEnabled
Параметр ESNEnabled указывает, следует ли включать уведомления о карантине (прежнее название — уведомления о нежелательной почте конечных пользователей) для политики. Допустимые значения:
- $true. Уведомления о карантине включены.
- $false. Уведомления о карантине отключены. Пользователь может получить доступ к сообщениям, помещенным в карантин, только в карантине, а не в Уведомления по электронной почте. Это значение используется по умолчанию.
Примечание. Если значение этого параметра равно $true, а значение параметра EndUserQuarantinePermissionsValue равно 0 (нет доступа, где отключены все разрешения), пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-Identity
Параметр Identity указывает политику карантина, которую требуется изменить. Можно использовать любое значение, однозначно определяющее политику карантина. Например:
- имя;
- различающееся имя (DN);
- GUID
Тип: | QuarantineTagIdParameter |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-IgnoreDehydratedFlag
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-IncludeMessagesFromBlockedSenderAddress
Параметр IncludeMessagesFromBlockedSenderAddress указывает, следует ли отправлять уведомления о карантине для сообщений, помещенных в карантин, с заблокированных адресов отправителей. Допустимые значения:
- $true: получатели получают уведомления о карантине для затронутых сообщений от заблокированных отправителей.
- $false: получатели не получают уведомления о карантине для затронутых сообщений от заблокированных отправителей. Это значение используется по умолчанию.
Тип: | Boolean |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-MultiLanguageCustomDisclaimer
Параметр MultiLanguageCustomDisclaimer указывает пользовательский текст заявления об отказе, который будет использоваться в нижней части уведомлений о карантине. Локализованный текст , Отказ от ответственности от вашей организации: всегда включается первым, а затем текст, указанный для этого параметра.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN')
. Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст пользовательского заявления об отказе. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
.
Тип: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-MultiLanguageSenderName
Параметр MultiLanguageSenderName указывает отображаемое имя отправителя электронной почты для использования в уведомлениях о карантине.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN')
. Для каждого языка, указанного с помощью параметра MultiLanguageSetting, можно указать уникальное имя отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
.
Тип: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-MultiLanguageSetting
Параметр MultiLanguageSetting указывает язык уведомлений о карантине. Допустимые значения:
Default, амхарский, арабский, баскский, бенгальский индейский, болгарский, каталанский, китайскийSimplified, китайскийтрадиционный, хорватский, кириллица, Английский, датский, голландский, филиппинский, финский, французский, галисийский, немецкий, греческий, Гуджарати, иврит, хинди, венгерский, исландский, индонезийский, итальянский, каннада, корейский, корейский, латышский, латышский, малайский, малайялам, маратхи, норвежский, одиа, персидский, польский, португальский, португальскийПортугал, румынский, русский, сербский, сербский кириллица, Словацкий, словенский, испанский, суахили, шведский, тамильский, телугу, тайский, турецкий, украинский, урду и вьетнамский.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN')
. Значение по умолчанию — Default, что означает, что уведомления о карантине используют язык по умолчанию облачной организации.
Для каждого указанного языка можно указать уникальное значение для параметров MultiLanguageCustomDisclaimer и MultiLanguageSenderName. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer и MultiLanguageSenderName в том же порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
.
Примечание. Значение английского языка сопоставляется со всеми кодами английского языка, кроме en-US. Если у вас есть пользователи только с почтовыми ящиками en-US, используйте значение По умолчанию. Если у вас есть сочетание почтовых ящиков с кодами en-US и других английских языков (en-GB, en-CA, en-AU и т. д.), используйте значение По умолчанию в одном настраиваемом уведомлении о карантине и значение English в другом настраиваемом уведомлении о карантине.
Тип: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
Параметр OrganizationBrandingEnabled включает или отключает фирменную символику организации в уведомлениях о карантине конечных пользователей. Допустимые значения:
- $true: включена фирменная символика организации. Логотип Майкрософт по умолчанию, используемый в уведомлениях о карантине, заменяется пользовательским логотипом. Перед этим необходимо выполнить инструкции, описанные в разделе Настройка темы Microsoft 365 для вашей организации для отправки пользовательского логотипа.
- $false: фирменная символика организации отключена. Логотип Майкрософт по умолчанию используется в уведомлениях о карантине. Это значение используется по умолчанию.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...
.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-QuarantineRetentionDays
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Применяется к: | Exchange Online, Exchange Online Protection |