Set-QuarantinePolicy

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Online, Exchange Online Protection

此指令程式只能在雲端式服務中使用。

使用 Set-QuarantinePolicy Cmdlet 來修改雲端式組織中的隔離原則。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

您無法修改名為 AdminOnlyAccessPolicy 或 DefaultFullAccessPolicy 的內建隔離原則。

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 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 值中需要額外的引號作為文字中引號字元的逸出字元。
  • 現有的使用者 aashutosh@contso.onmicrosoft.com 會作為隔離通知傳送者。
  • 先前設定的自訂標誌會取代預設的 Microsoft 標誌。
  • 隔離通知的頻率會變更為 4 小時。

參數

-AdminNotificationFrequencyInDays

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
  • 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 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

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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。 下列清單說明所需的順序，從最高 (1000000 或 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 = 00000000，因此請使用十進位值 0。
  • 有限存取：二進位 = 00011011，因此請使用十進位值 27。
  • 完整存取：二進位 = 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

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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

將保留此參數供 Microsoft 內部使用。

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、Amharic、Arabic、Basque、ArabiciIndia、Arabic、Arabic、ChineseSimplified、ChineseTraditional、Arabic、Cyrillic、 捷克文、丹麥文、荷蘭文、英文、愛沙尼亞文、芬蘭文、法文、Galician、德文、希臘文、古吉拉提文、希伯來文、印度文、匈牙利文、孟加拉國文、義大利文、日文、坎那達文、孟加拉國文、韓文、拉脫維亞文、芬蘭文、馬來亞蘭文、馬達提文、挪威文、挪威文、挪威文、匈牙利文、葡萄牙文、葡萄牙文、葡萄牙文、羅馬尼亞文、俄文、塞爾維亞文、塞爾維亞文 斯洛伐克文、斯洛維尼亞文、西班牙文、斯瓦利文、瑞典文、坦米文、泰文、泰文、土耳其文、烏克蘭文、烏德文和越南文。

您可以使用下列語法指定多個以逗號分隔的值： ('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 標誌會由您的自訂標誌取代。 執行此動作之前，您必須遵循 自訂群組織的 Microsoft 365 主題 中的指示，上傳您的自訂標誌。
  • $false：已停用組織商標。 預設的 Microsoft 標誌會用於隔離通知。 這是預設值。

此設定僅適用于內建隔離原則 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

將保留此參數供 Microsoft 內部使用。

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