QuarantinePolicy
Applies to : Exchange Online, Built-in security add-on for on-premises mailboxes
This cmdlet is available only in the cloud-based service.
Use the Set-QuarantinePolicy cmdlet to modify quarantine policies in your cloud-based organization.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
You can't modify the built-in quarantine policies named AdminOnlyAccessPolicy, DefaultFullAccessPolicy, or DefaultFullAccessWithNotificationPolicy.
You need to be assigned permissions before you can run this cmdlet. Although this article lists all parameters for the cmdlet, you might not have access to some parameters if they aren't included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.
Available cmdlets
Parameters
| Name | Type | Default value | Accepted values |
|---|---|---|---|
| AdminNotificationFrequencyInDays | Int32 | ||
| 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 | |
| AdminNotificationsEnabled | Boolean | ||
| AdminQuarantinePermissionsList | MultiValuedProperty | ||
| CustomDisclaimer | String | ||
| DomainController | Fqdn | ||
| EndUserQuarantinePermissions | QuarantinePermissions | ||
| EndUserQuarantinePermissionsValue | Int32 | ||
| EndUserSpamNotificationCustomFromAddress | String | ||
| EndUserSpamNotificationFrequency | TimeSpan | ||
| EndUserSpamNotificationFrequencyInDays | Int32 | ||
| 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 | |
| EsnCustomSubject | MultiValuedProperty | ||
| ESNEnabled | Boolean | ||
| IgnoreDehydratedFlag | SwitchParameter | ||
| IncludeMessagesFromBlockedSenderAddress | Boolean | False | |
| MultiLanguageCustomDisclaimer | MultiValuedProperty | ||
| MultiLanguageSenderName | MultiValuedProperty | ||
| MultiLanguageSetting | MultiValuedProperty | ||
| OrganizationBrandingEnabled | Boolean | ||
| QuarantineRetentionDays | Int32 |
Examples
Example 1
Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1 This example configures the permissions in the quarantine policy named CustomAccess that allows users to delete quarantined messages only.
Example 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 [email protected] -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00 This example modifies the global settings for quarantine notifications (formerly known as end-user spam notification settings):
- Quarantine notifications are customized for English, Chinese, and French. Extra quotation marks are required in the French MultiLanguageCustomDisclaimer value as escape characters for the quotation mark characters in the text.
- The existing user [email protected] is used as the quarantine notification sender.
- The previously configured custom logo replaces the default Microsoft logo.
- The frequency of quarantine notifications is changed to 4 hours.