Ping-Web.ps1

<#
.Synopsis
   Sends web requests to the specified URL.
.DESCRIPTION
   Verifies connectivity to a web page or web service by repeatedly sending web requests.
.EXAMPLE
   .\Ping-Web.ps1 -URL google.com
.EXAMPLE
   .\Ping-Web.ps1 -URL google.com -CsvFile .\ping-web_data.csv
.EXAMPLE
   .\Ping-Web.ps1 -URL google.com -Count 4
.EXAMPLE
   .\Ping-Web.ps1 -URL google.com -SleepSec 3
.EXAMPLE
   .\Ping-Web.ps1 -URL google.com -T
.EXAMPLE
   .\Ping-Web.ps1 -URL google.com -TimeoutSec 10
.LINK
    https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/invoke-webrequest
.NOTES
   Author:  Cesar Garcia
   Version:  1.2
   Date Modified:  2025-09-02
#>

[CmdletBinding()]
Param(
    # The Uniform Resource Identifier (URL) of the internet resource to which the web request is sent.
    # Enter a URL. This parameter only supports HTTP or HTTPS protocols.
    [String] $URL = "google.com",

    # Specifies the number of requests to be sent.
    # A value of 0 specifies an unlimited number of requests.
    [ValidateRange(1, [UInt]::MaxValue)]
    [UInt] $Count = 4,

    # Specifies how long to wait in between requests.
    # Enter a value in seconds.
    [ValidateRange(0, [UInt]::MaxValue)]
    [UInt] $SleepSec = 1,

    # Sends web requests until stopped.
    # To stop - type Control-C
    [switch] $T = $False,

    # Specifies how long the request can be pending before it times out.
    # Enter a value in seconds.
    # The default value of 0 specifies an indefinite time-out.
    [ValidateRange(0, [UInt]::MaxValue)]
    [UInt] $TimeoutSec = 0,

    # Specifies a .CSV file to save data to.
    # If not specified, results are saved to a temporary file.
    [String] $CsvFile
)

Write-Host "Sending web requests to: $URL"

If ($CsvFile -eq "") {
    $TmpFile = [System.IO.Path]::GetTempFileName()
    $CsvFile = [System.IO.Path]::ChangeExtension($TmpFile, ".csv")
}

Write-Host "Results will be saved to: $CsvFile"

[UInt64] $n = 1
While( $T.IsPresent -or ( $n -le $Count ) ) {

    [System.DateTime] $startTime = Get-Date

    $results = [PSCustomObject]@{
        Count                   = $n
        URL                     = $URL
        StartTime               = $startTime.ToString('O')
        StatusCode              = $Null
        StatusDescription       = $Null
        ResponseTimeInMS        = $Null
        RawResponseLength       = $Null
    }

    Try {
        [Microsoft.PowerShell.Commands.WebResponseObject] `
        $response = Invoke-WebRequest -URI $URL -TimeoutSec $TimeoutSec -DisableKeepAlive
        $results.StatusCode         = $response.StatusCode
        $results.StatusDescription  = $response.StatusDescription
        $results.RawResponseLength  = $response.RawContentLength
    }
    Catch [Microsoft.PowerShell.Commands.HttpResponseException] {
        $results.StatusCode         = [int] $PSitem.Exception.Response.StatusCode
        $results.StatusDescription  = $PSitem.Exception.Response.StatusCode
    }
    Catch [System.Net.Sockets.SocketException] {
        $results.StatusCode         = $PSItem.Exception.StatusCode
        $results.StatusDescription  = $PSItem.Exception.Message
    }
    Catch {
        $results.StatusCode         = $response.StatusCode
        $results.StatusDescription  = $PSItem.Exception.Message
    }
    Finally {
        [TimeSpan] $responseTime = (New-TimeSpan -Start $startTime -End (Get-Date))
        $results.ResponseTimeInMS = $responseTime.TotalMilliseconds
    }

    Write-Host $results | Format-Table -AutoSize
    if( $CsvFile ) {
        Write-Output $results | Export-Csv -Path $CsvFile -Append -NoTypeInformation -Force
    }

    Start-Sleep -Seconds $SleepSec

    $n++
}

Write-Host "Results have been saved to: $CsvFile`n"
Write-Host "Ping-Web statistics for $URL`:"
Import-Csv -Path $CsvFile | Measure-Object -Property ResponseTimeInMS -AllStats