共用方式為


Set-QuarantinePolicy

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

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

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

語法

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 或參數所需的權限,請參閱 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 內部使用。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-AdminNotificationLanguage

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

類型: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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

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

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-AdminQuarantinePermissionsList

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

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-Confirm

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

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-CustomDisclaimer

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

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-DomainController

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

類型:Fqdn
Position:Named
預設值: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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissionsValue

EndUserQuarantinePermissionsValue 參數會指定隔離原則的用戶權力。

此參數使用從二進位值轉換的十進位值。 二進位值會對應至特定順序的可用許可權清單。 針對每個許可權,值 1 等於 True,而值 0 等於 False。 下列清單說明所需的順序,從最高 (1000000 或 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 = 00000000,因此請使用十進位值 0。
  • 有限存取:二進位 = 00101011,因此請使用十進位值 43。
  • 完整存取:二進位 = 00100111,因此請使用十進位值 39。

針對自定義許可權,取得對應至您所要許可權的二進位值。 將二進位值轉換成要使用的十進位值。 請勿使用這個參數的二進位值。

注意:如果此參數的值為 0 ([沒有存取) ],且 ESNEnabled 參數的值$true,則使用者可以在隔離區中檢視其郵件,但郵件的唯一可用動作是 [檢視訊息標頭]

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationCustomFromAddress

EndUserSpamNotificationCustomFromAddress 會指定現有內部寄件者的電子郵件位址,以作為隔離通知的發件者。 若要將此參數設定回預設電子郵件位址 quarantine@messaging.microsoft.com,請使用值$null。

類型:String
Position:Named
預設值: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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

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

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationLanguage

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

類型: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
預設值: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
別名:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-ESNEnabled

ESNEnabled 參數會指定是否啟用隔離通知, (先前稱為原則的使用者垃圾郵件通知) 。 有效值為:

  • $true:已啟用隔離通知。
  • $false:隔離通知已停用。 使用者只能存取隔離區中隔離的郵件,不能在電子郵件通知中存取。 這是預設值。

注意:如果此參數的值為 $true,且 EndUserQuarantinePermissionsValue 參數的值為 0 (在所有許可權都關閉) 的情況下,沒有存取權,則使用者可以在隔離中檢視其郵件,但郵件的唯一可用動作是 檢視郵件標頭

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-Identity

Identity 參數會指定您想要修改的隔離原則。 您可以使用可唯一識別隔離原則的任何值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • GUID
類型:QuarantineTagIdParameter
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-IncludeMessagesFromBlockedSenderAddress

IncludeMessagesFromBlockedSenderAddress 參數會指定是否要從封鎖的發件者位址傳送隔離郵件的隔離通知。 有效值為:

  • $true:收件者會收到來自封鎖發件者之受影響郵件的隔離通知。
  • $false:收件者不會收到來自封鎖發件者之受影響郵件的隔離通知。 這是預設值。
類型:Boolean
Position:Named
預設值: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
預設值: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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 ...

注意:英文值會對應至 en-US 以外的每個英文程序代碼。 如果您只有具有 en-US 信箱的使用者,請使用預設值。 如果您將信箱與其他英文語言代碼混合 (en-GB、en-CA、en-AU 等 ) ,請在一個自定義隔離通知中使用 Default 值,並在另一個自定義隔離通知中使用英文值。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

OrganizationBrandingEnabled 參數會啟用或停用使用者隔離通知訊息中的組織商標。 有效值為:

  • $true:已啟用組織商標。 隔離通知中使用的預設Microsoft標誌會由您的自定義標誌取代。 執行此動作之前,您必須遵循 自定義組織Microsoft 365 主題 中的指示,上傳您的自定義標誌。
  • $false:已停用組織商標。 隔離通知中會使用預設Microsoft標誌。 這是預設值。

此設定只能在內建隔離原則中使用,該原則名為 DefaultGlobalTag,可控制全域設定。 若要存取此隔離原則,請使用下列語法啟動命令: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ...

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-QuarantineRetentionDays

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

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-WhatIf

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

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection