共用方式為


Set-QuarantinePolicy

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

使用 Set-QuarantinePolicy cmdlet 修改雲端組織中的隔離政策。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Default (預設值)

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

Description

你無法修改內建的隔離政策,名稱為 AdminOnlyAccessPolicy、DefaultFullAccessPolicy 或 DefaultFullAccessWithNotificationPolicy。

您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 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

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AdminNotificationLanguage

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:EsnLanguage
預設值: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
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AdminNotificationsEnabled

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AdminQuarantinePermissionsList

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用:Exchange Online,內建本地信箱安全外掛

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

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CustomDisclaimer

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EndUserQuarantinePermissions

適用:Exchange Online,內建本地信箱安全外掛

注意:在隔離政策中設定權限時,我們建議使用 EndUserQuarantinePermissionsValue 參數。

EndUserQuarantinePermissions 透過使用 New-QuarantinePermissions 或 Set-QuarantinePermissions 指令輸出中的變數,指定隔離政策的終端使用者權限。

例如,執行以下指令將所需權限存入變數中: $Perms = New-QuarantinePermissions <permissions>。 在同一個 PowerShell 工作階段中,使用該參數的值 $Perms

參數屬性

類型:QuarantinePermissions
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EndUserQuarantinePermissionsValue

適用:Exchange Online,內建本地信箱安全外掛

EndUserQuarantinePermissionsValue 參數指定了隔離政策的終端使用者權限。

這個參數使用一個從二進位值轉換而來的小數值。 二進位值對應於特定順序下的可用權限清單。 對於每個權限,值 1 等於 True,值 0 等於 False。 所需順序如下,從最高 (1000000或128) 到最低 (00000001 或1) :

  • PermissionToViewHeader:值 0 不會隱藏隔離中的 「檢視訊息」標頭 動作。 如果訊息在隔離中可見,該動作始終可用。
  • 授權下載:此權限不使用 (值 0 或 1) 無效。
  • 允許發送者許可
  • BlockSender 授權
  • 許可請求釋放:不要將此權限和許可釋放設定為 1。 將一個值設為 1,另一個設為 0,或兩者皆設為 0。
  • 授權釋放:不要將此權限和請求釋放權限設為 1。 將一個值設為 1,另一個設為 0,或兩者皆設為 0。 此權限不適用於被隔離為惡意軟體或高信心釣魚的訊息。 若隔離政策賦予使用者此權限,使用者可申請釋放隔離中的惡意軟體或高信任度釣魚訊息,彷彿選擇了 PermissionToRequestRelease 一樣。
  • 預覽權限
  • 授權刪除

預設終端使用者權限群組的值如下列表說明:

  • 無存取權:二進位 = 0000000,因此使用小數值 0。
  • 有限存取:二進位 = 00101011,因此使用小數值 43。
  • 完全存取:二進位 = 00100111,因此使用小數值 39。

自訂權限時,請取得對應你想要權限的二進位值。 將二進位值轉換成十進位值以便使用。 不要用這個參數的二進位值。

注意:若此參數值為 0 (無存取) 且 ESNEnabled 參數值為 $true,使用者可在隔離狀態查看訊息,但訊息唯一可用的動作是 「檢視訊息標頭」。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EndUserSpamNotificationCustomFromAddress

適用:Exchange Online,內建本地信箱安全外掛

EndUserSpamNotificationCustomFromAddress 指定已存在內部寄件人的電子郵件地址,作為隔離通知的寄件人。 要將此參數設回預設電子郵件地址 quarantine@messaging.microsoft.com,請使用值$null。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示: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
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EndUserSpamNotificationFrequencyInDays

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EndUserSpamNotificationLanguage

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:EsnLanguage
預設值: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
不要顯示: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
預設值:None
支援萬用字元:False
不要顯示:False
別名:多價值財產

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ESNEnabled

適用:Exchange Online,內建本地信箱安全外掛

ESNEnabled 參數規定是否啟用隔離通知 (先前稱為終端使用者垃圾通知的政策) 。 有效值為:

  • $true:隔離通知已啟用。
  • $false:隔離通知已停用。 使用者只能在隔離期間存取隔離郵件,無法透過電子郵件通知存取。 這個值是預設值。

注意:若此參數值為$true且 EndUserQuarantinePermissionsValue 參數值為 0 () 關閉所有權限時無權限,使用者可查看隔離中的訊息,但訊息唯一可用的操作是「 檢視訊息標頭」。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:Exchange Online,內建本地信箱安全外掛

Identity 參數指定你想修改的隔離政策。 你可以使用任何能唯一識別隔離政策的值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • GUID

參數屬性

類型:QuarantineTagIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IgnoreDehydratedFlag

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IncludeMessagesFromBlockedSenderAddress

適用:Exchange Online,內建本地信箱安全外掛

IncludeMessagesFromBlockedSenderAddress 參數指定是否對被封鎖寄件人地址的隔離訊息發送隔離通知。 有效值為:

  • $true:收件人會收到來自被封鎖寄件人受影響郵件的隔離通知。
  • $false:收件人不會收到來自被封鎖寄件人影響訊息的隔離通知。 這個值是預設值。

參數屬性

類型:Boolean
預設值:False
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MultiLanguageCustomDisclaimer

適用:Exchange Online,內建本地信箱安全外掛

MultiLanguageCustomDisclaimer 參數指定隔離通知底部附近的自訂免責聲明文字。 在地化文字「 A disclaimer from your organization: 」總是放在最前面,接著是你為此參數指定的文字。

你可以用語法 ('value1',''value2',...'valueN')以逗號分隔多個值:。 對於你用 MultiLanguageSetting 參數指定的每種語言,你都需要指定獨特的自訂免責聲明文字。 務必將對應的 MultiLanguageSetting、MultiLanguageCustomDisclaimer、EsnCustomSubject 和 MultiLanguageSenderName 參數值依照相同順序排列。

要修改現有值並保留其他值,你需要依照現有順序指定所有現有值和新值。

此設定僅在內建的隔離政策 DefaultGlobalTag 中可用,該政策控制全域隔離政策設定。 要存取此隔離政策,請以以下語法開始您的指令: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MultiLanguageSenderName

適用:Exchange Online,內建本地信箱安全外掛

MultiLanguageSenderName 參數指定電子郵件寄件人在隔離通知中使用的顯示名稱。

你可以用語法 ('value1',''value2',...'valueN')以逗號分隔多個值:。 對於你用 MultiLanguageSetting 參數指定的每種語言,都可以指定一個唯一的寄件者名稱。 務必將對應的 MultiLanguageSetting、MultiLanguageCustomDisclaimer 和 MultiLanguageSenderName 參數值以相同順序排列。

要修改現有值並保留其他值,你需要依照現有順序指定所有現有值和新值。

此設定僅在內建的隔離政策 DefaultGlobalTag 中可用,該政策控制全域設定。 要存取此隔離政策,請以以下語法開始您的指令: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MultiLanguageSetting

適用:Exchange Online,內建本地信箱安全外掛

MultiLanguageSetting 參數指定隔離通知的語言。 有效值為:

預設、阿姆哈拉語、阿拉伯語、巴斯克語、孟加拉語、印度、保加利亞語、加泰隆尼亞語、中文簡體、中文繁體、克羅埃西亞語、西里爾字母、捷克語、丹麥語、荷蘭語、英語、愛沙尼亞語、菲律賓語、芬蘭語、法語、加利西亞語、德語、希臘語、古吉拉特語、希伯來語、印地語、匈牙利語、冰島語、印尼語、義大利語、日語、卡納達語、哈薩克語、韓語、拉脫維亞語、立陶宛語、馬來語、馬拉地語、挪威語、紐諾爾斯克語、奧里亞語、波斯語、波蘭語、葡萄牙語、葡萄牙語、羅馬尼亞語、俄語、塞爾維亞語、塞爾維亞西里爾字母, 斯洛伐克語、斯洛維尼亞語、西班牙語、斯瓦希里語、瑞典語、泰米爾語、泰盧固語、泰語、土耳其語、烏克蘭語、烏爾都語及越南語。

你可以用語法指定多個以逗號分隔的值: ('value1',''value2',...'valueN')。 預設值為 Default,意即隔離通知使用雲端組織的預設語言。

對於你指定的每種語言,你可以為 MultiLanguageCustomDisclaimer 和 MultiLanguageSenderName 參數指定一個唯一的值。 務必將對應的 MultiLanguageSetting、MultiLanguageCustomDisclaimer 和 MultiLanguageSenderName 參數值以相同順序排列。

此設定僅在內建的隔離政策 DefaultGlobalTag 中可用,該政策控制全域設定。 要存取此隔離政策,請以以下語法開始您的指令: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...

注意:英文值對應至除 en-US 外的所有英語語言代碼。 如果你有只使用美國本土郵箱的使用者,請使用「Default」這個值。 如果你有包含 en-US 和其他英語代碼的信箱, (en-GB、en-CA、en-AU ) 等,請在一個自訂隔離通知中使用 Default 值,另一個自訂隔離通知則使用英文值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OrganizationBrandingEnabled

適用:Exchange Online,內建本地信箱安全外掛

OrganizationBrandingEnabled 參數可啟用或停用終端使用者隔離通知訊息中的組織品牌。 有效值為:

  • $true:組織品牌已啟用。 隔離通知中預設的 Microsoft 標誌會被你的自訂標誌取代。 在此之前,你需要依照「 自訂 Microsoft 365 主題 」中的指示,為你的組織上傳自訂標誌。
  • $false:組織品牌被禁用。 隔離通知中使用預設的 Microsoft 標誌。 這個值是預設值。

此設定僅在內建的隔離政策 DefaultGlobalTag 中可用,該政策控制全域設定。 要存取此隔離政策,請以以下語法開始您的指令: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-QuarantineRetentionDays

適用:Exchange Online,內建本地信箱安全外掛

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

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用:Exchange Online,內建本地信箱安全外掛

WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters