Test-SmtpConnectivity
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Test-SmtpConnectivity コマンドレットを使用して、特定のサーバー上の受信コネクタに対して、SMTP 接続を正常に確立できるかどうかを診断します。 このコマンドレットは、特定のサーバーの SMTP 接続を検証するために手動で実行することができますが、主に Microsoft System Center Operations Manager 2007 で使用し、トランスポート サーバー上のすべての受信コネクタの各バインドに対して、SMTP 接続を受信できるかどうかをテストします。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Test-SmtpConnectivity
[[-Identity] <ServerIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>] 説明
メールボックス サーバーに対して Test-SmtpConnectivity コマンドレットを実行すると、そのサーバー上でホストされているすべての受信コネクタのすべてのバインドに対して、SMTP 接続の確立が試行されます。 試行のたびに次の情報が返されます。
- Server:受信コネクタをホストするサーバーの名前です。
- ReceiveConnector:SMTP 接続が試行された受信コネクタの名前です。
- Binding:受信コネクタ上で構成されているバインドです。
- EndPoint:SMTP 接続が試行された実際の IP アドレスおよびポートです。
- StatusCode: 接続試行の結果。 これは、成功、接続できない、一時的なエラー、永続的なエラー、外部エラーのいずれかです。
- Details:テストされているサーバーから受信した実際の応答です。 接続試行が失敗した場合は、このフィールドにエラー文字列が含まれます。
結果をファイルに書き込むには、出力をConvertTo-HtmlまたはConvertTo-Csvにパイプしてコマンドに追加 > <filename> します。 (例: Test-SmtpConnectivity Mailbox01 | ConvertTo-Csv > "C:\My Documents\SMTP Test.csv")。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Test-SmtpConnectivity Mailbox01この例では、Mailbox01 という名前のメールボックス サーバー上のすべての受信コネクタに対して、SMTP 接続を検証します。
例 2
Get-TransportService | Test-SmtpConnectivityこの例では、組織のすべてのメールボックス サーバー上のすべての受信コネクタに対して、SMTP 接続を検証します。
パラメーター
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで 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 |
-DomainController
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
| 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 |
-Identity
Identity パラメーターは、コマンドレットが SMTP 接続を検証するトランスポート サーバーを指定します。
Identity パラメーターは、SMTP 接続を確認するトランスポート サーバーを指定します (指定したサーバー上のすべての受信コネクタをテストします)。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
このパラメーターを使用しない場合は、ローカル サーバー上のすべての受信コネクタがテストされます。
| Type: | ServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MonitoringContext
MonitoringContext パラメーターは、関連する監視イベントとパフォーマンス カウンターを結果に含めるかどうかを指定します。 有効な値は次のとおりです。
- $true: 監視イベントとパフォーマンス カウンターがコマンドの結果に含まれます。 通常、出力が System Center Operations Manager (SCOM) に渡されるときに、結果に監視イベントとパフォーマンス カウンター Microsoft含めます。
- $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 |
-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 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。