Test-NetworkPortRemote

Windows: Tests TCP connectivity to a specific port on a remote host

Script

#Requires -Version 5.1
#Requires -Modules NetTCPIP

[CmdletBinding()]
Param (
    [Parameter(Mandatory = $true)]
    [string]$Destination,

    [Parameter(Mandatory = $true)]
    [int]$Port,

    [string]$ComputerName = $env:COMPUTERNAME,

    [pscredential]$Credential
)

Process {
    try {
        $scriptBlock = {
            Param($Dest, $P)
            $result = Test-NetConnection -ComputerName $Dest -Port $P -ErrorAction SilentlyContinue
            return $result
        }

        if ($ComputerName -ne $env:COMPUTERNAME) {
            $invokeParams = @{
                'ComputerName' = $ComputerName
                'ScriptBlock'  = $scriptBlock
                'ArgumentList' = @($Destination, $Port)
                'ErrorAction'  = 'Stop'
            }
            if ($null -ne $Credential) {
                $invokeParams.Add('Credential', $Credential)
            }

            $testResult = Invoke-Command @invokeParams
        }
        else {
            $testResult = &$scriptBlock -Dest $Destination -P $Port
        }

        $output = [PSCustomObject]@{
            SourceComputer = $ComputerName
            Destination    = $Destination
            Port           = $Port
            TcpTestSucceeded = $testResult.TcpTestSucceeded
            PingSucceeded  = $testResult.PingSucceeded
            Timestamp      = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }

        Write-Output $output
    }
    catch {
        throw
    }
}

Customize

Destination string

Specifies the hostname or IP address of the target machine to test.

Port int

Specifies the TCP port number to test.

ComputerName string

Specifies the name of the computer from which the test should be initiated. Defaults to the local computer.

env string

Credential pscredential

Specifies a PSCredential object for remote connection.