Set-MailboxJunkEmailConfiguration

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。

使用 Set-MailboxJunkEmailConfiguration Cmdlet 來設定信箱中的垃圾郵件設定。

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

語法

Default (預設值)

Set-MailboxJunkEmailConfiguration
    [-Identity] <MailboxIdParameter>
    [-BlockedSendersAndDomains <MultiValuedProperty>]
    [-Confirm]
    [-ContactsTrusted <Boolean>]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-FailOnError <Boolean>]
    [-IgnoreDefaultScope]
    [-SenderScreeningEnabled <Boolean>]
    [-TrustedListsOnly <Boolean>]
    [-TrustedRecipientsAndDomains <MultiValuedProperty>]
    [-TrustedSendersAndDomains <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Description

此 Cmdlet 會控制信箱中的下列垃圾郵件設定:

  • 啟用或停用垃圾郵件規則:在內部部署 Exchange 中,垃圾郵件規則 (名為 [垃圾郵件] 規則的隱藏收件匣規則) 根據組織或信箱) 的 SCL 垃圾郵件資料夾閾值 (,控制將郵件傳送到 [垃圾郵件Email Email] 資料夾或收件匣或信箱以及信箱上的安全清單集合。

    在雲端式服務中,垃圾郵件規則對郵件流程沒有影響。 系統會根據反垃圾郵件原則中設定的動作,將郵件傳送到 Junk Email 資料夾。 信箱上的垃圾郵件規則仍會根據信箱的安全清單集合,控制傳送後郵件的處理方式。

    使用者可以使用 Outlook 網頁版,在自己的信箱中啟用或停用垃圾郵件規則。

  • 設定安全清單集合:安全清單集合是 [安全寄件者] 清單、[安全收件者] 清單和 [封鎖的寄件者] 清單。 使用者可以使用 Microsoft Outlook 或 Outlook 網頁版 在自己的信箱上設定安全清單集合。

如需詳細資訊,請參閱 在信箱上設定 Exchange 反垃圾郵件設定。

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

範例

範例 1

Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false

此範例會為名為 David Pelton 的使用者停用垃圾郵件規則。 在內部部署 Exchange 中,不會再根據組織或信箱) 的 SCL 垃圾Email資料夾閾值或信箱的安全清單集合,在收件匣和垃圾郵件Email資料夾之間移動郵件 (。 在 Exchange Online 中,信箱的安全清單集合無法在 Inbox 和 Junk Email 資料夾之間移動郵件。 系統仍會根據反垃圾郵件原則的判定和對應動作,將郵件傳送到 Junk Email 資料夾。

範例 2

Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}

此範例對名為 Michele Martin 之使用者的安全清單集合進行下列設定變更:

  • 新增 contoso.com 和 fabrikam.com 至 [安全的寄件者] 清單,而不影響其他現有項目。
  • jane@fourthcoffee.com新增到 [封鎖的寄件者] 清單,而不影響其他現有項目。

範例 3

Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false

此範例會識別將連絡人視為信任寄件者的信箱,然後變更垃圾郵件設定,不將連絡人視為信任的寄件者。

參數

-BlockedSendersAndDomains

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

BlockedSendersAndDomains 參數會指定 [封鎖的寄件者] 清單,其郵件會自動傳送至 [垃圾郵件] 資料夾的寄件者電子郵件地址和網域的清單Email。 這個參數對應於Outlook 網頁版設定:將電子郵件從這些寄件者或網域移至 [垃圾郵件Email] 資料夾。

若要輸入多個值並覆寫現有的項目,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。

若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

參數屬性

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

參數集

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

-Confirm

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

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

參數屬性

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

參數集

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

-ContactsTrusted

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ContactsTrusted 參數會指定是否將 [連絡人] 資料夾中的連絡人視為信任的寄件者。 此參數對應至 Outlook 網頁版設定:信任來自我的連絡人的電子郵件。 有效值為:

  • $true:無論內容為何,來自 [連絡人] 資料夾中連絡人的郵件一旦到達信箱,都不會傳送到 [垃圾郵件Email] 資料夾。
  • $false:系統不會將 [連絡人] 資料夾中連絡人的郵件視為信任的寄件者。 只有在 [安全的寄件者] 清單中定義該電子郵件地址時,該電子郵件地址才是受信任的寄件者。 此值為預設值。

參數屬性

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

參數集

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

-DomainController

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

參數屬性

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

參數集

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

-Enabled

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Enabled 參數會啟用或停用信箱上的垃圾郵件規則, (名為 [垃圾郵件規則) ] 的隱藏收件匣規則。 有效值為:

  • $true:已在信箱中啟用垃圾郵件規則。 這個值會對應至 網頁型 Outlook 設定: 自動篩選垃圾郵件。 此值為預設值。

    在內部部署 Exchange 中,信箱的安全清單集合 ([安全寄件者] 清單、[安全收件者] 清單和 [封鎖的寄件者] 清單) ,以及組織或信箱的 SCL 垃圾郵件Email資料夾閾值 () 將郵件傳遞至 [收件匣] 或 [垃圾郵件Email] 資料夾。

    在雲端式服務中,信箱的安全清單集合會在 Inbox 或 Junk Email 資料夾之間移動已傳送的郵件。 僅根據反垃圾郵件策略的判定和相應操作將郵件發送到 Junk Email 資料夾。

  • $false:已停用信箱中的垃圾郵件規則。 這個值會對應至 網頁型 Outlook 設定: 不要將電子郵件移到我的 [垃圾郵件] 資料夾。

    在內部部署 Exchange 中,信箱的安全清單集合或 SCL Junk Email 資料夾閾值無法將郵件傳遞至 Inbox 或 Junk Email 資料夾。

    在雲端式服務中,信箱的安全清單集合無法在 Inbox 或 Junk Email 資料夾之間移動已傳送郵件。 系統仍會根據反垃圾郵件原則的判定和對應動作,將郵件傳送到 Junk Email 資料夾。

您可以執行下列其中一個命令來尋找 [啟用] 屬性值,以檢視垃圾郵件規則的狀態:

  • Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>
  • 僅限內部部署 Exchange: Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden

信箱上的垃圾郵件規則狀態不會影響 Outlook 垃圾郵件篩選器中可用的用戶端垃圾郵件設定Email。 即使已停用信箱中的垃圾郵件規則,Outlook 仍可將郵件移至 [垃圾郵件Email] 資料夾。 例如,如果 Outlook 判斷郵件是垃圾郵件,或寄件者是在 [封鎖的寄件者] 清單中定義,Outlook 可以將郵件移至 [垃圾郵件Email] 資料夾。 如需詳細資訊,請參閱 Junk Email 篩選概觀。

參數屬性

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

參數集

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

-FailOnError

適用:Exchange Online

此參數只能在雲端式服務中使用。

{{ 填滿 FailOnError 描述 }}

參數屬性

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

參數集

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

-Identity

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Identity 參數會指定要修改的信箱。 您可以使用可唯一識別信箱的任何值。 例如:

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

參數屬性

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

參數集

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

-IgnoreDefaultScope

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

IgnoreDefaultScope 參數會告知命令忽略 Exchange PowerShell 工作階段的預設收件者範圍設定,並使用整個樹系作為範圍。 您不需要使用此參數指定值。

此參數可讓命令存取預設範圍中目前不可用的 Active Directory 物件,但也會引進下列限制:

  • 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
  • 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。

參數屬性

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

參數集

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

-SenderScreeningEnabled

適用:Exchange Online

此參數只能在雲端式服務中使用。

{{ 填滿 SenderScreeningEnabled 描述 }}

參數屬性

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

參數集

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

-TrustedListsOnly

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

TrustedListsOnly 參數會指定僅傳送來自 [安全的寄件者] 清單中寄件者的郵件到收件匣。 所有其他郵件都會視為垃圾郵件。 此參數會對應至 Outlook 網頁版設定: 請勿信任電子郵件,除非電子郵件來自我的安全寄件者和收件者清單中的某個人。 有效值為:

  • $true:只有來自 [安全寄件者] 清單和安全收件者清單中電子郵件地址或網域項目的郵件會傳送到 [收件匣]。 所有其他郵件都會自動傳送到 Junk Email 資料夾。
  • $false:來自其他寄件者、收件者和網域的郵件不會自動視為垃圾郵件,而是個別評估。 此值為預設值。

參數屬性

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

參數集

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

-TrustedRecipientsAndDomains

適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

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

參數集

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

-TrustedSendersAndDomains

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

TrustedSendersAndDomains 參數會指定 [安全寄件者] 清單和安全收件者清單,這是電子郵件地址和網域的清單。 無論內容為何,來自這些寄件者到達信箱的郵件永遠不會傳遞到 Junk Email 資料夾。 此參數對應至 Outlook 網頁版設定:請勿將電子郵件從這些寄件者或網域移至我的 Junk Email 資料夾。

若要輸入多個值並覆寫現有的項目,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"。

若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

若要清空電子郵件地址和網域清單,請使用值 $null。

附註:

  • 您無法新增與收件者電子郵件地址來自相同網域的寄件者電子郵件地址。 全域通訊清單中的所有信箱 (GAL) 都會自動視為信任的寄件者。
  • 您無法使用此 Cmdlet 直接修改安全收件者清單。 您可以使用這個參數來修改 [安全寄件者] 清單,而電子郵件地址和網域就會同步處理至 [安全收件者] 清單。
  • 在使用目錄同步處理的混合式 Exchange 組織中,預設不會同步網域項目,但您可以啟用網域的同步。 如需詳細資訊,請參閱設定內容篩選要使用安全網域資料。

參數屬性

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

參數集

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

-WhatIf

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

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

參數集

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

CommonParameters

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

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。