Posts RSS Comments RSS 253 Posts and 411 Comments till now

Test-Port (kinda like portqry without verbose output)

We had a little dicussion on forums about the most efficient way to Test a machine before trying a WMI query against it (as it has a log timeout.) My first suggestion was to use a ping (WMI style) but Jeff from brought up a valid point… what if ICMP is NOT Allowed…

Enter Test-Port. This nifty little script uses the TCPClient Class to test connectivity. Stay tuned as I am planning some mods.

– Takes parameter $srv for Server Name
– Takes Parameter for Port, Defaults to 135 for RPC mapper.
– Takes Timeout.. defaults to 3000 (miliseconds)
– If it cannot connect within timeout… Returns $false
– If it gets exception connecting to port… Returns $false
– If it connects… Returns $True

function Test-Port{
    $ErrorActionPreference = "SilentlyContinue"
    $tcpclient = new-Object system.Net.Sockets.TcpClient
    $iar = $tcpclient.BeginConnect($srv,$port,$null,$null)
    $wait = $iar.AsyncWaitHandle.WaitOne($timeout,$false)
        if($verbose){Write-Host "Connection Timeout"}
        Return $false
        $tcpclient.EndConnect($iar) | out-Null
        if($error[0]){if($verbose){write-host $error[0]};$failed = $true}
    if($failed){return $false}else{return $true}

7 Responses to “Test-Port (kinda like portqry without verbose output)”

  1. on 20 Sep 2007 at 9:39 amJoel "Jaykul" Bennett

    This is the VERB police: Pull Over.

    Sir, do you realize that “Test” is the officially recognized verb for checking things? Yeah, that’s what I thought. Consider this a warning.

    Have a nice day.

  2. […] As you might guess what we need is a pipeline from Get-QADComputer to Move-QADObject with some kind of where -not pingable in between. Luckily thanks to our fellow MVP Brandon we have the script doing the ping. […]

  3. […] PPS: Скрипт test-port можно взять тут, для админов – must have. Posted by xaegr Filed in PowerShell […]

  4. on 22 Mar 2008 at 7:54 ambyty

    Maybe this is an silly question. How do you call this function ?
    Test-Port(IP) ?

  5. on 22 Mar 2008 at 7:59 amBrandon

    I used Test-Port because Test is an Approved Verb and Port is what I am testing 🙂

    more Info Here

  6. on 22 Mar 2008 at 11:45 ambyty

    That is not my question. My question was how you can put the IP in the script by function name ( parameters)?
    But i change the line.. Param([string]$srv=’′,$port=80,$timeout=3000,[switch]$verbose)

    And it seams to work. when i call test-port.

    But if you use it like an function… test-port( ….. ) …. = what parameters do you need to enter? I tested with test-port(‘’) in the ps1 file that has the function… and with is not working…

  7. on 22 Mar 2008 at 12:33 pmBrandon

    Perhaps I still do not understand your question.

    to use this . source the ps1 file and then just call the function.

    . c:\scripts\test-port.ps1
    test-port “”

    Another option is to remove the function{ and ending }

Trackback this post | Feed on Comments to this post

Leave a Reply

You must be logged in to post a comment.