Set-MailboxJunkEmailConfiguration

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または別の環境に限定される場合があります。

Set-MailboxJunkEmailConfiguration コマンドレットを使用して、メールボックスでの迷惑メールの設定を構成します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

このコマンドレットは、メールボックスでの以下の迷惑メールの設定を制御します。

  • 迷惑メール ルールを有効または無効にします。オンプレミスの Exchange では、迷惑メール ルール (迷惑メール ルールという名前の非表示の受信トレイ ルール) が、SCL 迷惑メール フォルダーのしきい値 (organizationまたはメールボックス) とメールボックスのセーフリスト コレクションに基づいて、迷惑メール フォルダーまたは受信トレイへのメッセージEmail Email配信を制御します。

    クラウドベースのサービスでは、迷惑メール ルールはメール フローには影響しません。 メッセージは、スパム対策ポリシーで設定されたアクションに基づいて [Junk Email] フォルダーに配信されます。 引き続き、メールボックスの迷惑メール ルールは、メールボックスのセーフリスト コレクションに基づいて、配信後のメッセージに対する処理を制御します。

    ユーザーは、Outlook on the web を使用して、自分のメールボックスで迷惑メール ルールを有効または無効にすることができます。

  • セーフリスト コレクションを構成する: セーフリスト コレクションは [信頼できる差出人のリスト] と、[信頼できる宛先のリスト] と、[受信拒否リスト] から成ります。 ユーザーは、Microsoft Outlook または Outlook on the web を使用して、自分のメールボックスでセーフリスト コレクションを構成できます。

詳細については、「Configure Exchange antispam settings on mailboxes」を参照してください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false

この例では、David Pelton という名前のユーザーの迷惑メール ルールを無効にします。 オンプレミスの Exchange では、SCL 迷惑Emailメール フォルダーのしきい値 (organization またはメールボックス) またはメールボックスのセーフリスト コレクションに基づいて、受信トレイと迷惑メール Email フォルダーの間でメッセージが移動されなくなりました。 Exchange Online では、メールボックスのセーフリスト コレクションは、受信トレイと 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 パラメーターは、メッセージが Junk Email フォルダーに自動的に送信される送信者の電子メール アドレスとドメインのリストである [Blocked Senders] リストを指定します。 このパラメーターは、Outlook on the web の設定に対応します: これらの送信者またはドメインから My Junk Email フォルダーに電子メールを移動する。

複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス用の組み込みセキュリティ アドオンメールボックス

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置: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 on the web の設定に対応します。連絡先からのメールを信頼する。 有効な値は次のとおりです。

  • $true: メールボックスに届いた [連絡先] フォルダー内の連絡先からのメッセージは、内容にかかわらず [迷惑メール] フォルダーに送られません。
  • $false: [連絡先] フォルダー内の連絡先からのメッセージは、信頼済みの差出人として扱われません。 [信頼できる差出人のリスト] で定義されているメール アドレスのみが信頼済みの差出人となります。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置: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 on the web の設定に対応します。迷惑メールを自動的にフィルター処理する。 この値が既定値です。

    オンプレミスの Exchange では、メールボックスのセーフリストコレクション (信頼できる差出人のリスト、信頼できる宛先のリスト、およびブロックされた差出人のリスト) と SCL Junk Email フォルダーのしきい値 (organization またはメールボックスの場合) によって、受信トレイまたは Junk Email フォルダーにメッセージが配信されます。

    クラウドベースのサービスでは、メールボックスのセーフリスト コレクションによって、配信されたメッセージが受信トレイまたは Junk Email フォルダーの間で移動します。 メッセージは、スパム対策ポリシーの判定と対応するアクションのみに基づいて Junk Email フォルダーに配信されます。

  • $false: 迷惑メールの仕訳ルールがメールボックスで無効にされます。 この値は、Outlook on the web の設定に対応します。Don't move email to my Junk Email folder.

    オンプレミスの Exchange では、メールボックスのセーフリスト コレクションまたは SCL Junk Email フォルダーのしきい値では、受信トレイまたは Junk Email フォルダーにメッセージを配信できません。

    クラウドベースのサービスでは、メールボックスのセーフリスト コレクションは、受信トレイまたは Junk Email フォルダーの間で配信済みメッセージを移動できません。 メッセージは、スパム対策ポリシーの判定と対応するアクションに基づいて、引き続き Junk Email フォルダーに配信されます。

以下のコマンドのいずれかを実行して、Enabled プロパティの値を確認することにより、迷惑メールの仕訳ルールの状態を表示することができます。

  • Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>
  • オンプレミスの Exchange のみ: Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden

メールボックスの迷惑メール ルールの状態は、Outlook Junk Email フィルターで使用できるクライアント側の迷惑メール設定には影響しません。 メールボックスで迷惑メール ルールが無効になっている場合でも、Outlook はメッセージを Junk Email フォルダーに移動できます。 たとえば、Outlook がメッセージをスパムと判断した場合、または送信者が [受信拒否リスト] に定義されている場合、Outlook はメッセージを [Junk Email] フォルダーに移動できます。 詳細については、「Junk Email フィルターの概要」を参照してください。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FailOnError

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill: FailOnError: 説明 }}

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス用の組み込みセキュリティ アドオンメールボックス

Identity パラメーターは、変更するメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

パラメーターのプロパティ

型:MailboxIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置: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 パラメーターは使用できません。 このコマンドは、適切なグローバル カタログ サーバーを自動的に使用します。
  • Identity パラメーターの DN しか使用できません。 エイリアスや GUID などの他の形式の ID は使用できません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SenderScreeningEnabled

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill SenderScreeningEnabled description }}

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置: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 on the web の設定に対応します。[信頼できる差出人と宛先] リストに登録されているユーザーからのものでない限り、メールを信頼しない。 有効な値は次のとおりです。

  • $true: [信頼できる差出人のリスト] および [信頼できる宛先のリスト] に含まれるメール アドレスまたはドメイン エントリからのメッセージのみが受信トレイに送られます。 他のすべてのメッセージは、自動的に [迷惑メール] フォルダーに振り分けられます。
  • $false: 他の差出人、受信者、ドメインからのメッセージは、自動的に迷惑メールとして扱われることはなく、それぞれ個別に検証されます。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TrustedRecipientsAndDomains

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

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置: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 on the web の設定に対応します: これらの送信者またはドメインから My Junk Email フォルダーに電子メールを移動しないでください。

複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。

メール アドレスとドメインのリストを空にするには、$null という値を使用します。

注:

  • 送信者のメール アドレスと同じドメインの送信者のメール アドレスを追加することはできません。 グローバル アドレス一覧 (GAL) 内のすべてのメールボックスは、自動的に信頼できる送信者と見なされます。
  • このコマンドレットを使用して、[信頼できる宛先のリスト] を直接変更することはできません。 このパラメーターを使用して [信頼できる差出人のリスト] を変更すると、メール アドレスとドメインは [信頼できる宛先のリスト] へ同期されます。
  • ディレクトリ同期を使用するハイブリッド Exchange 組織では、ドメイン エントリは既定では同期されませんが、ドメインの同期を有効にすることができます。 詳細については、「安全なドメイン データを使用するようにコンテンツ フィルタリングを構成する」を参照してください。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置: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
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。