Test-NetConnection
Test-NetConnection
Displays diagnostic information for a connection.
構文
Parameter Set: CommonTCPPort
Test-NetConnection [[-ComputerName] <String> ] [-CommonTCPPort] <String> [-InformationLevel <String> ] [ <CommonParameters>]
Parameter Set: ICMP
Test-NetConnection [[-ComputerName] <String> ] [-Hops <Int32> ] [-InformationLevel <String> ] [-TraceRoute] [ <CommonParameters>]
Parameter Set: RemotePort
Test-NetConnection [[-ComputerName] <String> ] -Port <Int32> [-InformationLevel <String> ] [ <CommonParameters>]
詳細説明
The Test-NetConnection cmdlet displays diagnostic information for a connection. The output includes the results of a DNS lookup, a listing of IP interfaces, an option to test a TCP connection, IPsec rules, and confirmation of connection establishment.
パラメーター
-CommonTCPPort<String>
Specifies the common service TCP port number. このパラメーターに対して使用できる値:
-- SMB
-- HTTP
-- RDP
-- PING
エイリアス |
なし |
必須? |
true |
位置は? |
2 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ComputerName<String>
Specifies the Domain Name System (DNS) name or IP address of the target computer that runs the Dynamic Host Configuration Protocol (DHCP) server service.
エイリアス |
RemoteAddress,cn |
必須? |
false |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
True (ByValue, ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Hops<Int32>
Specifies the number of hops to traverse in a trace route command.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-InformationLevel<String>
Specifies the information level. このパラメーターに対して使用できる値:
-- Detailed
-- Quiet
If you set this parameter to Quiet, the cmdlet returns a Boolean value that indicates if the attempt to ping a host or port succeeded.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Port<Int32>
Specifies the TCP port number on the remote computer. The cmdlet uses this port number to test connectivity to the remote machine.
エイリアス |
RemotePort |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-TraceRoute
Indicates that Tracert runs to test connectivity to the remote host.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
- none
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
NetConnectionResults
Results of the connectivity test to the specified computer name
例
Example 1: Test a connection
This command tests a network connection.
PS C:\> Test-NetConnection
Example 2: Test a connection and display detailed results
This command tests a network connection and sets the InformationLevel parameter to Detailed.
PS C:\> Test-NetConnection -Port 80 -InformationLevel Detailed
Example 3: Test a connection to a remote host
This command tests a network connection to a remote host named www.contoso.com.
PS C:\> Test-NetConnection -ComputerName www.contoso.com -InformationLevel Detailed