New-QuarantinePolicy

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

使用 New-QuarantinePolicy Cmdlet 在雲端式組織中建立隔離原則。

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

Syntax

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>]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantinePolicyType <QuarantinePolicyType>]
   [-QuarantineRetentionDays <Int32>]
   [<CommonParameters>]

Description

隔離原則會根據郵件遭到隔離的原因, (針對支援的功能) 和隔離通知設定,定義允許使用者對隔離郵件執行的動作。 如需詳細資訊,請參閱 隔離原則

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0

此範例會建立名為 ContosoTag 的新隔離原則,其許可權與 [無存取預設許可權] 群組相同。

若要指派有限的存取權限,請使用值 27。 若要指派完整存取權限,請使用值 23。

參數

-AdminDisplayName

AdminDisplayName 參數會指定隔離原則的描述。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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

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

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

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

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 。

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

-MultiLanguageCustomDisclaimer

將保留此參數供 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

-MultiLanguageSenderName

將保留此參數供 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

-MultiLanguageSetting

將保留此參數供 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

-Name

Name 參數會指定隔離原則的唯一名稱。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

將保留此參數供 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

-QuarantinePolicyType

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

Type:QuarantinePolicyType
Accepted values:QuarantinePolicy, GlobalQuarantinePolicy
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