Test-Connection

Test-Connection
    [-ComputerName] <String[]>
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Test-Connection
    [-ComputerName] <String[]>
    [-Source] <String[]>
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Credential <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [<CommonParameters>]

Test-Connection
    [-ComputerName] <String[]>
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [-BufferSize <Int32>]
    [-Count <Int32>]
    [-Impersonation <ImpersonationLevel>]
    [-TimeToLive <Int32>]
    [-Delay <Int32>]
    [-Quiet]
    [<CommonParameters>]

Test-Connection cmdlet은 하나 이상의 원격 컴퓨터에 ICMP(Internet Control Message Protocol) 에코 요청 패킷 또는 ping을 보내고 에코 응답 응답을 반환합니다. 이 cmdlet을 사용하여 IP 네트워크를 통해 특정 컴퓨터에 연결할 수 있는지 여부를 확인할 수 있습니다.

Test-Connection 매개 변수를 사용하여 보내는 컴퓨터와 받는 컴퓨터를 모두 지정하고, 명령을 백그라운드 작업으로 실행하고, 시간 제한 및 ping 수를 설정하고, 연결 및 인증을 구성할 수 있습니다.

친숙한 ping 명령과 달리 Test-Connection PowerShell에서 조사할 수 있는 Win32_PingStatus 개체를 반환합니다. Quiet 매개 변수는 테스트된 각 연결에 대해 System.Boolean 개체 내에 있는 부울 값을 반환합니다. 여러 연결을 테스트하는 경우 불리언 값의 배열이 반환됩니다.

이 예제에서는 로컬 컴퓨터에서 Server01 컴퓨터로 에코 요청 패킷을 보냅니다.

Test-Connection -ComputerName Server01

Source        Destination     IPV4Address     IPV6Address  Bytes    Time(ms)
------        -----------     -----------     -----------  -----    --------
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       0
ADMIN1        Server01         10.59.137.44                32       1

Test-Connection ComputerName 매개 변수를 사용하여 Server01 컴퓨터를 지정합니다.

이 예제에서는 로컬 컴퓨터에서 여러 원격 컴퓨터로 ping을 보냅니다.

Test-Connection -ComputerName Server01, Server02, Server12

이 예제에서는 다른 원본 컴퓨터에서 단일 원격 컴퓨터인 Server01로 ping을 보냅니다.

Test-Connection -Source Server02, Server12, localhost -ComputerName Server01 -Credential Domain01\Admin01

Test-Connection 자격 증명 매개 변수를 사용하여 원본 컴퓨터에서 ping 요청을 보낼 권한이 있는 사용자의 자격 증명을 지정합니다. 이 명령 형식을 사용하여 여러 지점에서 연결 대기 시간을 테스트합니다.

이 예제에서는 Test-Connection 매개 변수를 사용하여 명령을 사용자 지정합니다. 로컬 컴퓨터는 원격 컴퓨터에 ping 테스트를 보냅니다.

Test-Connection -ComputerName Server01 -Count 3 -Delay 2 -TTL 255 -BufferSize 256 -ThrottleLimit 32

Test-Connection 는 ComputerName 매개 변수를 사용하여 Server01을 지정합니다. Count 매개 변수는 2초 간격의 딜레이와 함께 세 개의 ping이 Server01 컴퓨터로 전송되는 것을 나타냅니다.

홉 수가 길거나 트래픽이 많은 네트워크 조건으로 인해 ping 응답이 평소보다 오래 걸릴 것으로 예상되는 경우 이러한 옵션을 사용할 수 있습니다.

이 예제에서는 Test-Connection 명령을 PowerShell 백그라운드 작업으로 실행하는 방법을 보여줍니다.

$job = Test-Connection -ComputerName (Get-Content Servers.txt) -AsJob
if ($job.JobStateInfo.State -ne "Running") {$Results = Receive-Job $job}

Test-Connection 명령은 엔터프라이즈의 많은 컴퓨터를 ping합니다. ComputerName 매개 변수의 값은 Get-Content컴퓨터 이름 목록을 읽는 Servers.txt file 명령입니다. 이 명령은 AsJob 매개 변수를 사용하여 명령을 백그라운드 작업으로 실행하고 작업을 $job 변수에 저장합니다.

if 명령은 작업이 아직 실행되고 있지 않은지 확인합니다. 작업이 실행되고 있지 않으면 Receive-Job 결과를 가져오고 $Results 변수에 저장합니다.

이 명령은 Test-Connection cmdlet을 사용하여 원격 컴퓨터를 ping합니다.

Test-Connection Server55 -Credential Domain55\User01 -Impersonation Identify

이 명령은 자격 증명 매개 변수를 사용하여 원격 컴퓨터를 ping할 수 있는 권한이 있는 사용자 계정과 Impersonation 매개 변수를 지정하여 가장 수준을 식별변경합니다.

다음은 컴퓨터에 전송된 ping 중 하나 이상이 성공한 경우에만 Server01 컴퓨터에 세션을 만드는 예제입니다.

if (Test-Connection -ComputerName Server01 -Quiet) {New-PSSession Server01}

if 명령은 Test-Connection cmdlet을 사용하여 Server01 컴퓨터를 ping합니다. 이 명령은 Win32_PingStatus 개체 대신 부울 값을 반환하는 Quiet 매개 변수를 사용합니다. 4개의 ping 중 어느 것이 성공하면 값이 $true, 그렇지 않으면 $false.

Test-Connection 명령이 $true값을 반환하는 경우 명령은 New-PSSession cmdlet을 사용하여 PSSession만듭니다.

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

기본적으로 이 cmdlet은 각 ping 회신에 대한 Win32_PingStatus 개체를 반환합니다.

이 cmdlet은 AsJob 매개 변수를 지정하는 경우 작업 개체를 반환합니다.

Quiet 매개 변수를 사용하면 부울 값이 반환됩니다. cmdlet이 여러 연결을 테스트하는 경우 불리언 값의 배열을 반환합니다.

이 cmdlet은 Win32_PingStatus 클래스를 사용합니다. Get-WmiObject Win32_PingStatus 명령은 Test-Connection 명령과 동일합니다.

Source 매개 변수 집합은 PowerShell 3.0에서 도입되었습니다.