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 |