New-QuarantinePolicy
此指令程式只能在雲端式服務中使用。
使用 New-QuarantinePolicy 指令小程式在雲端組織中建立隔離政策。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
New-QuarantinePolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantinePolicyType <QuarantinePolicyType>]
[-QuarantineRetentionDays <Int32>]
[<CommonParameters>]
Description
隔離政策會根據郵件被隔離的原因，定義使用者可對被隔離訊息做什麼， (支援功能) 及隔離通知設定。 如需詳細資訊，請參閱 隔離原則。
您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0
此範例建立了一個名為 ContosoTag 的新隔離政策，權限與 No access preset 權限群組相同。
要指派有限存取權限，請使用數值 27。 要指派完全存取權限，請使用數值 23。
參數
-AdminDisplayName
適用：Exchange Online，內建本地信箱安全外掛
AdminDisplayName 參數指定隔離政策的描述。 如果值包含空格，請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-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 |
-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。
參數屬性
| 類型: | 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 |
-IncludeMessagesFromBlockedSenderAddress
適用：Exchange Online，內建本地信箱安全外掛
IncludeMessagesFromBlockedSenderAddress 參數指定是否對被封鎖寄件人地址的隔離訊息發送隔離通知。 有效值為：
- $true：收件人會收到來自被封鎖寄件人受影響郵件的隔離通知。
- $false：收件人不會收到來自被封鎖寄件人影響訊息的隔離通知。 這個值是預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MultiLanguageCustomDisclaimer
適用：Exchange Online，內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MultiLanguageSenderName
適用：Exchange Online，內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MultiLanguageSetting
適用：Exchange Online，內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用：Exchange Online，內建本地信箱安全外掛
名稱參數指定隔離政策的唯一名稱。 如果值包含空格，請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OrganizationBrandingEnabled
適用：Exchange Online，內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QuarantinePolicyType
適用：Exchange Online，內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | QuarantinePolicyType |
| 預設值: | None |
| 接受的值: | QuarantinePolicy, GlobalQuarantinePolicy |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-QuarantineRetentionDays
適用：Exchange Online，內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | Int32 |
| 預設值: | 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。