cmnetworkports

0.2.3

public/Test-CmSiteSystemPorts.ps1

<#
.SYNOPSIS
    Test if Required Ports are open
.DESCRIPTION
    Test if required ports per site system role are open from the local host
.PARAMETER SiteCode
    3-character ConfigMgr Site Code
.PARAMETER PrimaryServer
    ConfigMgr Primary site server or SMS Provider FQDN
.EXAMPLE
    Test-CmSiteSystemPorts -SiteCode "P01" -PrimaryServer "cm01.contoso.local"
.NOTES
.OUTPUTS
#>
function Test-CmSiteSystemPorts {
    [CmdletBinding()]
    param (
        [parameter(Mandatory=$True)][string][ValidateLength(3,3)]$SiteCode,
        [parameter(Mandatory=$True)][string][ValidateNotNullOrEmpty()]$PrimaryServer
    )
    $sitelist = Get-CmSiteSystemPorts -SiteCode $SiteCode -PrimaryServer $PrimaryServer
    Write-Host "this needs more work to control the port queries per direction (inbound/outbound)"
    $pass = @()
    $fail = @()
    foreach ($item in $sitelist) {
        $server   = $item.ComputerName
        if ($server -ne '(Clients)') {
            $portdata = $item.Port -split ':'
            $porttype = $portdata[0]
            $portnum  = $portdata[1]
            $portdesc = $item.Description
            if ($portnum -notlike '*-*') {
                $test = "$server,$portnum"
                try {
                    if (($pass -notcontains $test) -and ($fail -notcontains $test)) {
                        if ($porttype -eq 'TCP') {
                            if ((Test-NetConnection -ComputerName $server -Port $portnum -ErrorAction SilentlyContinue).TcpTestSucceeded) {
                                $pass += $test
                                $stat = 'pass'
                            } else {
                                $fail += $test
                                $stat = 'fail'
                            }
                        } else {
                            Write-Host "test UDP connection to port $portnum"
                            #Test-NetConnectionUDP
                            $stat = 'fail'
                        }
                        [pscustomobject]@{
                            Status = $stat
                            ComputerName = $server
                            Port   = $portnum
                            Type   = $porttype
                            Description = $portdesc
                        }
                    } else {
                        Write-Verbose "already tested: $server $($item.port)"
                    }
                }
                catch {
                    Write-Error $_.Exception.Message
                    $fail += $test
                }    
            } else {
                Write-Verbose "skipping port range: $($item.port)"
            }
        } else {
            Write-Verbose "skipping clients for now"
        }
    }
}