PingMon – A PowerShell Ping Monitor Script

  3 Responses to “PingMon – A PowerShell Ping Monitor Script”

1. 

   Wes says:

   May 11, 2010 at 11:24 pm

   Hi,

   Great script! I only have one problem & maybe you can help me out. If i create a function of hte script like:

   Function ping {C:\PingMon.ps1}

   & i use in powershell:
   ping server01

   i get the response:

   ERROR: This script requires arguments

   so i guess i have to put something behind c:\pingmon.ps1 like

   Function ping {C:\PingMon.ps1 captureinput}

   but dunno how (i’m a n00b ).

   does anyone know?
2. 

   Kahuna says:

   May 12, 2010 at 9:22 am

   Hi Wes,

   If you want to use this within another script, just rip out the existing “DoPing” function and put it in your script. You can then call the “DoPing” function like this:

   DoPing server01

   if you want to call this script from another script, don’t try to turn it into a function, just invoke it from within your script as you would from the PowerShell commandline:

   ./pingmon.ps1 server01
3. 

   aztec-codex says:

   June 10, 2011 at 12:32 am

   Nice script.

   I had the problem, that the output can’t be used with the | Out-File — command, so I added the parameter -e for output with the echo-command:

   
$psScriptName = "PingMon.ps1"
$psScriptAuth = "Kahuna at PoshTips.com"
$psScriptDate = "12/19/2009"
##############################################################################
## PingMon.ps1
##
## Original Script by Kahuna at PoshTips.com - 11/19/2009
##
## Maintenance (most recent updates at top):
## Date By Comments
## ---------- --- ----------------------------------------------------------
## 11/19/2009 KPS new script
## 06/10/2011 LS add parameter -e
##
##############################################################################
$scriptUsage = @"
==============================================================================
SCRIPT : $psScriptName
AUTHOR : $psScriptAuth
VERSION : $psScriptDate
==============================================================================
PURPOSE:
powershell script to run a coninuous ping against a given host
and display time-stamped response times to the console with
color highlighting for high response times or time-outs

   USAGE:

   PingMon [-e] hostname [-?|-H]

   - From the PowerShell command-line, invoke the script, passing a single
   hostnames argument
   FLAGS:
   -? or -H = Display this help
   -e = Return in echo-commands (for Out-File - Command), not coloured.

   EXAMPLE:
   ./PingMon server1

   ==============================================================================
   "@

   Set-PSDebug -Trace 0
   $script:recCount = 0

   function ShowUsage([string]$message=""){
   $message
   $scriptUsage
   exit
   }

   function DoPing ([string]$hostname,[bool]$echo){
   #$erroractionpreference = "SilentlyContinue"
   $hostname = $hostname.trimend(".")
   $fqdn = [System.Net.Dns]::GetHostEntry($hostname).HostName

   if ($echo)
   {
   echo "Date Status ResponseTime Host (IP)"
   echo "------------------- ------ ------------- ------------------------------------"
   }
   else {
   write-host "Date Status ResponseTime Host (IP)" -foregroundcolor cyan -backgroundcolor darkblue
   write-host "------------------- ------ ------------- ------------------------------------" -foregroundcolor cyan -backgroundcolor darkblue
   # "YYYY-MM-DD_HH:MM:SS OK 9999999ms Host (xxx.xxx.xxx.xxx)"
   # "YYYY-MM-DD_HH:MM:SS FAIL TIMEOUT Host (xxx.xxx.xxx.xxx)"
   }

   $ping = new-object System.Net.NetworkInformation.Ping
   while(-1) {

   $ts = get-date -uformat %Y-%m-%d_%H:%M:%S
   $reply = $ping.send($hostname)
   if ($reply.status -eq "Success"){
   $x = [string]::Format("{0} {1} {2,7:D}ms {3} ({4})",
   $ts,
   "OK ",
   $reply.RoundtripTime,
   $fqdn,
   $reply.Address.ToString())

   if ($echo)
   { echo $x }
   else
   {
   if ($reply.RoundtripTime -le 10) {
   write-host $x -foregroundcolor darkgreen -backgroundcolor white
   }
   else {
   write-host $x -foregroundcolor Blue -backgroundcolor cyan
   }
   }
   }
   else {
   $x = [string]::Format("{0} {1} {2} {3} ({4})",
   $ts,
   "FAIL ",
   "TIMEOUT",
   $fqdn,
   "")

   if ($echo)
   { echo $x }
   else
   { write-host $x -foregroundcolor red -backgroundcolor yellow }
   }
   sleep 1
   }
   }

   ######################################################
## MAIN
######################################################
if ($args.count)
{
[bool]$echo = $False
# Process command-line flags
foreach ($item in $args)
{
if ($item -like "-*")
{
switch ($item)
{
"-H" {ShowUsage;}
"-?" {ShowUsage;}
"-e" {$echo = $True;}
default {ShowUsage "ERROR: $item is invalid!";}
}
}
}
# Process non-flag arguments
foreach ($item in $args) {
if ($item -notlike "-*") {
DoPing $item $echo
}
}
}
else
{
ShowUsage "ERROR: This script requires arguments"
}


   Example to use:

   .\PingMon.ps1 -e xxx.xxx.xxx.xxx | Out-File your-log-output.log