Set-MailboxJunkEmailConfiguration
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。
使用 Set-MailboxJunkEmailConfiguration 指令碼來設定信箱的垃圾郵件設定。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 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
此指令匣控制信箱上的以下垃圾郵件設定：
啟用或停用垃圾郵件規則：在本地 Exchange 中，垃圾郵件規則 (一個隱藏的收件匣規則，稱為垃圾郵件規則) ，根據組織或信箱) 及信箱安全清單集合的 SCL 垃圾郵件Email資料夾門檻 (，控制郵件投送至 Junk Email 資料夾或收件匣。
在雲端服務中，垃圾郵件規則不影響郵件流程。 訊息會根據反垃圾郵件政策中設定的行動，送達至垃圾郵件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 中，信箱的安全清單無法在收件匣與垃圾郵件（Junk Email）資料夾間移動郵件。 訊息仍會根據判決及反垃圾郵件政策的相應行動，送達至垃圾郵件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 參數指定了 Blocked Senders 清單，該清單列出寄件人電子郵件地址及網域，這些郵件會自動被送入 Junk Email 資料夾。 這個參數對應於 Outlook 網頁版的設定：將郵件從這些寄件人或網域移到我的垃圾郵件（Junk 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 |
| 別名: | 參見 |
參數集
(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
啟用參數用來啟用或停用信箱上的垃圾郵件規則， (一個名為垃圾郵件規則) 的隱藏收件匣規則。 有效值為：
$true：郵件信箱中已啟用垃圾郵件規則。 這個值會對應至 網頁型 Outlook 設定： 自動篩選垃圾郵件。 這個值是預設值。
在本地 Exchange 中，信箱的安全名單集合 (安全寄件人清單、安全收件人清單和被封鎖寄件人清單) ，以及組織或信箱的 SCL 垃圾郵件Email資料夾門檻 (，或郵件投送至收件匣或垃圾郵件Email資料夾的信箱) 。
在雲端服務中，信箱的安全清單集合會將已送達的郵件在收件匣或垃圾郵件Email資料夾間移動。 訊息僅根據反垃圾郵件政策的判決及相應行動，才會送達垃圾郵件Email資料夾。
$false：郵件箱中的垃圾郵件規則已停用。 這個值會對應至 網頁型 Outlook 設定： 不要將電子郵件移到我的 [垃圾郵件] 資料夾。
在本地 Exchange 中，信箱的安全名單集合或 SCL Junk Email 資料夾的門檻無法將郵件送達收件匣或 Junk Email 資料夾。
在雲端服務中，信箱的安全清單集合無法在收件匣與垃圾郵件Email資料夾間移動已送達郵件。 訊息仍會根據判決及反垃圾郵件政策的相應行動，送達至垃圾郵件Email資料夾。
您可以透過執行以下任一指令來查看垃圾郵件規則的狀態，以找到啟用屬性值：
Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>- 僅限現場交換：
Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden
郵箱上的垃圾郵件狀態不會影響 Outlook 垃圾郵件Email過濾器中可用的客戶端垃圾郵件設定。 即使郵箱裡的垃圾郵件規則被停用，Outlook 仍然可以將郵件移到垃圾郵件Email資料夾。 例如，如果 Outlook 判定該郵件是垃圾郵件，或寄件人已在「被封鎖的寄件人」列表中被定義，Outlook 可以將該郵件移到垃圾郵件（Junk Email）資料夾。 欲了解更多資訊，請參閱垃圾Email過濾器概述。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FailOnError
適用：Exchange Online
此參數只能在雲端式服務中使用。
{{ Fill 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 參數指定了安全寄件人清單和安全收件人清單，這兩個是電子郵件地址與網域的清單。 這些寄件人送達信箱的訊息，無論內容如何，都不會送達垃圾郵件Email資料夾。 這個參數對應於 Outlook 網頁版的設定：請勿將郵件從這些寄件人或網域移到 My 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 |
| 別名: | 威斯康辛 |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。