Test-Mailflow
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
メールボックス サーバーの役割がインストールされているコンピューターのシステム メールボックスからメールを正しく送信できるかどうかと、このシステム メールボックスにメールを正しく配信できるかどうかを診断するには、Test-Mailflow コマンドレットを使用します。 このコマンドレットを使用して、定義されている待ち時間のしきい値以内にメールボックス サーバー間で電子メールが送信されることを確認することもできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
AutoDiscoverTargetMailboxServer
Test-Mailflow
[[-Identity] <ServerIdParameter>]
[-AutoDiscoverTargetMailboxServer]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
CrossPremises
Test-Mailflow
-CrossPremises <Boolean>
[-ActiveDirectoryTimeout <Int32>]
[-CrossPremisesExpirationTimeout <EnhancedTimeSpan>]
[-CrossPremisesPendingErrorCount <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TargetDatabase
Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetDatabase <DatabaseIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TargetEmailAddress
Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetEmailAddress <String>
[-TargetEmailAddressDisplayName <String>]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TargetMailboxServer
Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetMailboxServer <ServerIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
SourceServer
Test-Mailflow
[[-Identity] <ServerIdParameter>]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
説明
Test-Mailflow コマンドレットでは、メールの送信、転送、および配信をテストします。 このコマンドレットは、各メールボックス サーバーでサーバー自身にメッセージを正しく送信できることを確認します。 また、このコマンドレットを使用して、あるメールボックス サーバー上のシステム メールボックスから別のメールボックス サーバー上のシステム メールボックスにメッセージを正しく送信できることを確認できます。 テストに関係するすべてのサーバーでシステム メールボックスが必要となります。
テスト メッセージは、ターゲット ユーザーまたはシステム メールボックスで使用できます。 メッセージの件名が Test-Mailflow <GUID>され、メッセージ本文にテキスト This is a Test-Mailflow probe messageが含まれています。
Test-Mailflow の結果が画面に表示されます。 結果に含まれる以下の値に注目してください。
- TestMailflowResult: 返される値は通常、Success または *FAILURE* です。
- MessageLatencyTime: テストを完了するために必要な時間 (テスト メッセージを配信します)。 この値では、構文 hh:mm:ss.ffff を使用します。hh = hours、mm = minutes、ss = seconds、ffff = fractions of a second。
Test-Mailflow 結果をファイルに書き込むには、出力を ConvertTo-Html または ConvertTo-Csv にパイプ処理し、コマンドに > <filename> を追加します。 例: Test-Mailflow -AutoDiscoverTargetMailboxServer | ConvertTo-Csv > "C:\My Documents\test-mailflow 2020-05-01.csv"。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2
この例では、サーバー Mailbox1 からサーバー Mailbox2 へのメッセージ フローがテストされます。 Mailbox1 に接続しているときに、このコマンドを実行する必要があります。
例 2
Test-Mailflow -TargetEmailAddress john@contoso.com
次の使用例は、このコマンドを実行しているローカル メールボックス サーバーから電子メール アドレス john@contoso.comへのメッセージ フローをテストします。
パラメーター
-ActiveDirectoryTimeout
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ActiveDirectoryTimeout パラメーターは、タスクが遅延に関する情報メッセージを送信するまでの経過時間を秒単位で指定します。 既定値は 15 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AutoDiscoverTargetMailboxServer
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
AutoDiscoverTargetMailboxServer スイッチは、テスト メッセージの送信先となるメールボックス サーバーの一覧を自動的に作成するかどうかを指定します。 このスイッチで値を指定する必要はありません。
タスクは Active Directory にクエリを実行してすべてのメールボックス サーバーを検出し、各サーバーにテスト メッセージを送信します。
このスイッチを使用するとき、CrossPremises、TargetDatabase、TargetEmailAddress、TargetMailboxServer の各パラメーターは使用できません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AutoDiscoverTargetMailboxServer
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CrossPremises
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
CrossPremises パラメーターは、メール フロー テストをクロスプレミス モードで実行するかどうかを指定します。
組織が社内外にまたがる展開を使用しており、社内外にまたがるメール フローを確認する必要がある場合、このパラメーターを $true に設定します。
このパラメーターを使用するとき、AutoDiscoverTargetMailboxServer、TargetDatabase、TargetEmailAddress、TargetMailboxServer の各パラメーターは使用できません。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
CrossPremises
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CrossPremisesExpirationTimeout
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
CrossPremisesExpirationTimeout パラメーターは、このコマンドレットが非同期の監視を行うために Microsoft System Center Operations Manager 2007 エージェントによって実行される場合に使用されます。 このコマンドレットを手動で実行する場合、このパラメーターを使用することはお勧めしません。
パラメーターのプロパティ
| 型: | EnhancedTimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
CrossPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CrossPremisesPendingErrorCount
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
CrossPremisesPendingErrorCount パラメーターは、このコマンドレットが非同期の監視を行うために System Center Operations Manager 2007 エージェントによって実行される場合に使用されます。 このコマンドレットを手動で実行する場合、このパラメーターを使用することはお勧めしません。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
CrossPremises
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ErrorLatency
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ErrorLatency パラメーターは、エラー イベントが Microsoft System Center Operations Manager 2007 に出力されるまでのテスト メッセージ配信の待機時間を指定します。 テスト メッセージがローカル メールボックス サーバーに送信される場合の既定値は 15 秒で、テスト メッセージがリモートのメールボックス サーバーに送信される場合の既定値は 180 秒です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExecutionTimeout
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ExecutionTimeout パラメーターには、テストが失敗と判断されるまでのタスクの最大実行時間を指定します。 この時間内にテスト メッセージまたは配信レポートが届かない場合、タスクは終了し、エラーが報告されます。 Exchange 管理シェルでタスクを実行する場合、既定の設定は 240 秒です。 MonitoringContext パラメーターを使用した場合の既定値は 15 秒です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity パラメーターには、テスト メッセージの送信元となるメールボックス サーバーの名前を指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
このパラメーターを使用しない場合、ローカル メールボックス サーバーが使用されます。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AutoDiscoverTargetMailboxServer
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
TargetDatabase
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
TargetEmailAddress
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
TargetMailboxServer
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
SourceServer
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-MonitoringContext
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
MonitoringContext パラメーターは、関連する監視イベントとパフォーマンス カウンターを結果に含めるかどうかを指定します。 有効な値は次のとおりです。
- $true: 監視イベントとパフォーマンス カウンターがコマンドの結果に含まれます。 通常、出力が Microsoft System Center Operations Manager (SCOM) に渡されるときに、監視イベントとパフォーマンス カウンターを結果に含めます。
- $false: 監視イベントとパフォーマンス カウンターは、コマンドの結果には含まれません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TargetDatabase
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
TargetDatabase パラメーターは、テスト メッセージの送信先となるメールボックス データベースを指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
このパラメーターは、AutoDiscoverTargetMailboxServer、CrossPremises、TargetEmailAddress、または TargetMailboxServer パラメーターでは使用できません。
パラメーターのプロパティ
| 型: | DatabaseIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
TargetDatabase
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TargetEmailAddress
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
TargetEmailAddress パラメーターは、テスト メッセージの送信先となるメールボックスの SMTP アドレスを指定します。 このパラメーターを使用して、リモート フォレストのメールボックス サーバーにテスト メッセージを送信します。 このパラメーターが使用されている場合、テストは常にリモート テストになります。
このパラメーターを使用するとき、AutoDiscoverTargetMailboxServer、CrossPremises、TargetDatabase、TargetMailboxServer の各パラメーターは使用できません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
TargetEmailAddress
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TargetEmailAddressDisplayName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
TargetEmailAddressDisplayName パラメーターは、TargetEmailAddress パラメーターが使用されるときに Microsoft System Center Operations Manager 2007 のイベントとレポートで使用されるカスタム表示名を指定します。 TargetEmailAddressDisplayName パラメーターを使用しない場合、イベントとレポートは、TargetEmailAddress パラメーターで指定される電子メールアドレスの値を使用します。
このパラメーターは TargetEmailAddress パラメーターでのみ使用でき、Microsoft System Center Operations Manager の外部のコマンドレットの出力には影響しません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
TargetEmailAddress
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TargetMailboxServer
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
TargetMailboxServer パラメーターは、テスト メッセージを送信するローカル Exchange organization内の 1 つ以上のメールボックス サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
このパラメーターを使用するとき、AutoDiscoverTargetMailboxServer、CrossPremises、TargetDatabase、TargetEmailAddress の各パラメーターは使用できません。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
TargetMailboxServer
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。