Set-MailboxJunkEmailConfiguration
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Set-MailboxJunkEmailConfiguration Cmdlet 在信箱上設定垃圾郵件設定。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Set-MailboxJunkEmailConfiguration
[-Identity] <MailboxIdParameter>
[-BlockedSendersAndDomains <MultiValuedProperty>]
[-Confirm]
[-ContactsTrusted <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IgnoreDefaultScope]
[-TrustedListsOnly <Boolean>]
[-TrustedRecipientsAndDomains <MultiValuedProperty>]
[-TrustedSendersAndDomains <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
此 Cmdlet 可控制信箱上的下列垃圾郵件設定:
啟用或停用垃圾郵件規則:在內部部署 Exchange 中,垃圾郵件規則 (名為垃圾郵件規則的隱藏收件匣規則,) 根據組織或信箱的信箱) 和安全清單集合的 SCL 垃圾郵件Email資料夾 (閾值,控制郵件傳遞至垃圾郵件Email資料夾或收件匣。
在雲端式服務中,垃圾郵件規則不會影響郵件流程。 Exchange Online Protection會根據反垃圾郵件原則中設定的動作,將訊息傳遞至垃圾郵件Email資料夾。 信箱上的垃圾郵件規則仍會根據信箱的安全清單集合,控制郵件傳遞後會發生什麼情況。
使用者可以使用Outlook 網頁版,在自己的信箱中啟用或停用垃圾郵件規則。
設定 safelist 集合:safelist 集合是 [安全寄件者] 清單、[安全收件者] 清單和 [封鎖的寄件者] 清單。 使用者可以使用 Microsoft Outlook 或 Outlook 網頁版,在自己的信箱上設定 safelist 集合。
如需詳細資訊, 請參閱在信箱上設定 Exchange 反垃圾郵件設定。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false
此範例會停用名為 DavidPelton 之使用者的垃圾郵件規則。 在內部部署 Exchange 中,訊息不再根據組織或信箱) 或信箱安全清單集合 (SCL 垃圾郵件Email資料夾閾值,在收件匣和垃圾郵件Email資料夾之間移動。 在Exchange Online中,信箱的安全清單集合無法在 [收件匣] 和 [垃圾郵件] Email資料夾之間移動郵件。 郵件仍會根據反垃圾郵件原則的決策和對應動作,傳遞至垃圾郵件Email資料夾。
範例 2
Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}
此範例會針對名為 Martine Martin 的使用者,對 safelist 集合進行下列組態變更:
- 將 contoso.com 和 fabrikam.com 新增至 [安全寄件者] 清單,而不會影響其他現有的專案。
- 將 新 jane@fourthcoffee.com 增至 [封鎖的寄件者] 清單,而不會影響其他現有的專案。
範例 3
Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false
此範例會識別將連絡人視為受信任寄件者的信箱,然後變更垃圾郵件設定,不將連絡人視為受信任的寄件者。
參數
-BlockedSendersAndDomains
BlockedSendersAndDomains 參數會指定 [封鎖的寄件者] 清單,這是寄件者電子郵件地址和網域的清單,其郵件會自動傳送至 [垃圾郵件] Email資料夾。 此參數會對應至Outlook 網頁版設定:將電子郵件從這些寄件者或網域移至我的垃圾郵件Email資料夾。
若要輸入多個值並覆寫任何現有的專案,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ContactsTrusted
ContactsTrusted 參數會指定是否將 [連絡人] 資料夾中的連絡人視為信任的寄件者。 此參數會對應至Outlook 網頁版設定:信任連絡人的電子郵件。 有效值為:
- $true:不論內容為何,來自 [連絡人] 資料夾中連絡信箱的連絡人的郵件永遠不會傳遞到 [垃圾郵件] Email資料夾。
- $false:來自 [連絡人] 資料夾中連絡人的訊息不會被視為受信任的寄件者。 只有在 [安全寄件者] 清單中定義電子郵件地址時,電子郵件地址才是受信任的寄件者。 這是預設值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Enabled 參數會啟用或停用信箱上的垃圾郵件規則, (名為垃圾郵件規則) 的隱藏收件匣規則。 有效值為:
$true:信箱中已啟用垃圾郵件規則。 這個值會對應至 網頁型 Outlook 設定: 自動篩選垃圾郵件。 這是預設值。
在內部部署 Exchange 中,信箱的安全清單集合 (安全寄件者清單、安全收件者清單和封鎖的寄件者清單) ,以及組織或信箱的 SCL 垃圾郵件Email資料夾閾值 (,) 將郵件傳遞至 [收件匣] 或 [垃圾郵件Email] 資料夾。
在雲端式服務中,信箱的安全清單集合會在 [收件匣] 或 [垃圾郵件] Email資料夾之間移動傳遞的郵件。 郵件只會根據反垃圾郵件原則的決策和對應動作,傳遞至垃圾郵件Email資料夾。
$false:信箱中已停用垃圾郵件規則。 這個值會對應至 網頁型 Outlook 設定: 不要將電子郵件移到我的 [垃圾郵件] 資料夾。
在內部部署 Exchange 中,信箱或 SCL 垃圾郵件Email資料夾閾值的安全清單集合無法將郵件傳遞至 [收件匣] 或 [垃圾郵件Email] 資料夾。
在雲端式服務中,信箱的安全清單集合無法在 [收件匣] 或 [垃圾郵件] 資料夾之間移動傳遞的郵件Email。 郵件仍會根據反垃圾郵件原則的決策和對應動作,傳遞至垃圾郵件Email資料夾。
您可以執行下列其中一個命令來尋找 Enabled 屬性值,以檢視垃圾郵件規則的狀態:
Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>
- 僅限內部部署 Exchange:
Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden
信箱上的垃圾郵件規則狀態不會影響 Outlook 垃圾郵件Email篩選器中可用的用戶端垃圾郵件設定。 即使信箱中已停用垃圾郵件規則,Outlook 仍然可以將郵件移至 [垃圾郵件] Email資料夾。 例如,如果 Outlook 判斷郵件是垃圾郵件,或寄件者定義于 [封鎖的寄件者] 清單中,Outlook 可以將郵件移至 [垃圾郵件] Email資料夾。 如需詳細資訊,請參閱垃圾郵件Email篩選概觀。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity 參數會指定要修改的信箱。 您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
IgnoreDefaultScope 參數會指示命令忽略 Exchange PowerShell 會話的預設收件者範圍設定,並使用整個樹系作為範圍。 您不需要使用此參數指定值。
此參數可讓 命令存取預設範圍中目前無法使用的 Active Directory 物件,但也引進下列限制:
- 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
- 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedListsOnly
TrustedListsOnly 參數會指定只有來自 [安全寄件者] 清單中寄件者的訊息才會傳遞至 [收件匣]。 所有其他訊息都會被視為垃圾郵件。 此參數會對應至Outlook 網頁版設定:除非電子郵件來自 [安全寄件者和收件者] 清單中的某人,否則請勿信任電子郵件。 有效值為:
- $true:只有來自 [安全寄件者] 清單和 [安全收件者] 清單中電子郵件地址或網域專案的郵件才會傳遞至 [收件匣]。 所有其他訊息都會自動傳遞至垃圾郵件Email資料夾。
- $false:來自其他寄件者、收件者和網域的郵件不會自動視為垃圾郵件,並個別評估。 這是預設值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedRecipientsAndDomains
將保留此參數供 Microsoft 內部使用。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedSendersAndDomains
TrustedSendersAndDomains 參數會指定 [安全寄件者] 清單和安全收件者清單,也就是電子郵件地址和網域的清單。 不論內容為何,來自這些寄件者到信箱的郵件永遠不會傳遞到垃圾郵件Email資料夾。 此參數對應至Outlook 網頁版設定:請勿將電子郵件從這些寄件者或網域移至我的垃圾郵件Email資料夾。
若要輸入多個值並覆寫任何現有的專案,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
若要清空電子郵件地址和網域的清單,請使用值$null。
附註:
- 您無法從與收件者電子郵件地址相同的網域新增寄件者電子郵件地址。 全域通訊清單中的所有信箱 (GAL) 會自動視為受信任的寄件者。
- 您無法使用此 Cmdlet 直接修改安全收件者清單。 您可以使用此參數來修改 [安全寄件者] 清單,並將電子郵件地址和網域同步至 [安全收件者] 清單。
- 在具有目錄同步處理的獨立 EOP 中,網域專案預設不會同步處理,但您可以啟用網域的同步處理。 如需詳細資訊,請參閱設定內容篩選要使用安全網域資料。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。