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]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantineRetentionDays <Int32>]
[-WhatIf]
[<CommonParameters>] Описание
Вы не можете изменить встроенные политики карантина с именем AdminOnlyAccessPolicy или DefaultFullAccessPolicy.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье 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
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationLanguage
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | EsnLanguage |
| Accepted values: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationsEnabled
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminQuarantinePermissionsList
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Для этих командлетов вы можете пропустить запрос подтверждения, используя точный синтаксис: -Confirm:$false.
- Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CustomDisclaimer
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-DomainController
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissions
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | QuarantinePermissions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissionsValue
Параметр EndUserQuarantinePermissionsValue указывает разрешения конечного пользователя для политики карантина.
Этот параметр использует десятичное значение, преобразованное из двоичного значения. Двоичное значение соответствует списку доступных разрешений в определенном порядке. Для каждого разрешения значение 1 равно True, а значение 0 — false. Требуемый порядок описан в следующем списке с самого высокого (10000000 или 128) до самого низкого (00000001 или 1):
- PermissionToViewHeader: значение 0 не скрывает действие Просмотр заголовка сообщения в карантине. Если сообщение отображается в карантине, действие всегда доступно для сообщения.
- PermissionToDownload: это разрешение не используется (значение 0 или 1 ничего не делает).
- PermissionToAllowSender: это разрешение не используется (значение 0 или 1 ничего не делает).
- PermissionToBlockSender
- PermissionToRequestRelease: не устанавливайте для этого разрешения и PermissionToRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или задайте для обоих значений значение 0.
- PermissionToRelease: не устанавливайте для этого разрешения и PermissionToRequestRelease значение 1. Задайте для одного значения значение 1, а для другого — 0 или задайте для обоих значений значение 0. Это разрешение не предоставляется для сообщений, которые были помещены в карантин как вредоносные программы или фишинг с высокой степенью достоверности. Если политика карантина предоставляет пользователям это разрешение, пользователи могут запрашивать выпуск их помещенных в карантин вредоносных программ или фишинговых сообщений с высокой степенью достоверности, как если бы вместо этого было выбрано PermissionToRequestRelease.
- PermissionToPreview
- PermissionToDelete
Значения для предустановленных групп разрешений конечных пользователей описаны в следующем списке:
- Нет доступа: Binary = 0000000, поэтому используйте десятичное значение 0.
- Ограниченный доступ: Binary = 00011011, поэтому используйте десятичное значение 27.
- Полный доступ: Binary = 00010111, поэтому используйте десятичное значение 23.
Для пользовательских разрешений получите двоичное значение, соответствующее нужным разрешениям. Преобразуйте двоичное значение в десятичное значение для использования. Не используйте двоичное значение для этого параметра.
Примечание. Если значение этого параметра равно 0 (нет доступа), а значение параметра ESNEnabled равно $true, пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationCustomFromAddress
EndUserSpamNotificationCustomFromAddress указывает адрес электронной почты существующего внутреннего отправителя, который будет использоваться в качестве отправителя для уведомлений о карантине. Чтобы задать для этого параметра адрес quarantine@messaging.microsoft.comэлектронной почты по умолчанию, используйте значение $null.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequency
Параметр EndUserSpamNotificationFrequency определяет частоту отправки уведомлений о карантине пользователям. Допустимые значения:
- 04:00:00 (4 часа)
- 1.00:00:00 (1 день)
- 7.00:00:00 (7 дней)
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequencyInDays
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationLanguage
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | EsnLanguage |
| Accepted values: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EsnCustomSubject
Параметр EsnCustomSubject указывает текст, используемый в поле Тема уведомлений о карантине.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | undefined |
| Aliases: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ESNEnabled
Параметр ESNEnabled указывает, следует ли включать уведомления о карантине (прежнее название — уведомления о нежелательной почте конечных пользователей) для политики. Допустимые значения:
- $true. Уведомления о карантине включены.
- $false. Уведомления о карантине отключены. Пользователь может получить доступ к сообщениям, помещенным в карантин, только в карантине, а не в Уведомления по электронной почте. Это значение используется по умолчанию.
Примечание. Если значение этого параметра равно $true, а значение параметра EndUserQuarantinePermissionsValue равно 0 (нет доступа, где отключены все разрешения), пользователи могут просматривать свои сообщения в карантине, но единственным доступным действием для сообщений является просмотр заголовка сообщения.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Параметр Identity указывает политику карантина, которую требуется изменить. Можно использовать любое значение, однозначно определяющее политику карантина. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | QuarantineTagIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IgnoreDehydratedFlag
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageCustomDisclaimer
Параметр MultiLanguageCustomDisclaimer указывает пользовательский текст заявления об отказе, который будет использоваться в нижней части уведомлений о карантине. Локализованный текст , Отказ от ответственности от вашей организации: всегда включается первым, а затем текст, указанный для этого параметра.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, необходимо указать уникальный текст пользовательского заявления об отказе. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет параметрами глобальной политики карантина. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageSenderName
Параметр MultiLanguageSenderName указывает отображаемое имя отправителя электронной почты для использования в уведомлениях о карантине.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Для каждого языка, указанного с помощью параметра MultiLanguageSetting, можно указать уникальное имя отправителя. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer и MultiLanguageSenderName в том же порядке.
Чтобы изменить существующее значение и сохранить другие значения, необходимо указать все существующие значения и новое значение в существующем порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageSetting
Параметр MultiLanguageSetting указывает язык уведомлений о карантине. Допустимые значения:
Default, амхарский, арабский, баскский, бенгальский индейский, болгарский, каталанский, китайскийSimplified, китайскийтрадиционный, хорватский, кириллица, Чешский, датский, голландский, английский, филиппинский, финский, французский, галисийский, немецкий, греческий, Гуджарати, иврит, хинди, венгерский, исландский, индонезийский, итальянский, каннада, корейский, корейский, латышский, латышский, малайский, малайялам, маратхи, норвежский, норвежский, nynornorsk, Odia, персидский, польский, португальский, португальскийPortugal, румынский, русский, сербский, сербский кириллица, Словацкий, словенский, испанский, суахили, шведский, тамильский, телугу, тайский, турецкий, украинский, урду и вьетнамский.
Можно указать несколько значений, разделенных запятыми, с помощью синтаксиса: ('value1',''value2',...'valueN'). Значение по умолчанию — Default, что означает, что уведомления о карантине используют язык по умолчанию облачной организации.
Для каждого указанного языка можно указать уникальное значение для параметров MultiLanguageCustomDisclaimer и MultiLanguageSenderName. Не забудьте выровнять соответствующие значения параметров MultiLanguageSetting, MultiLanguageCustomDisclaimer и MultiLanguageSenderName в том же порядке.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
Параметр OrganizationBrandingEnabled включает или отключает фирменную символику организации в уведомлениях о карантине конечных пользователей. Допустимые значения:
- $true: включена фирменная символика организации. Логотип Майкрософт по умолчанию, используемый в уведомлениях о карантине, заменяется пользовательским логотипом. Перед этим необходимо выполнить инструкции, описанные в разделе Настройка темы Microsoft 365 для вашей организации для отправки пользовательского логотипа.
- $false: фирменная символика организации отключена. Логотип Майкрософт по умолчанию используется в уведомлениях о карантине. Это значение используется по умолчанию.
Этот параметр доступен только во встроенной политике карантина с именем DefaultGlobalTag, которая управляет глобальными параметрами. Чтобы получить доступ к этой политике карантина, запустите команду с помощью следующего синтаксиса: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-QuarantineRetentionDays
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |