PowerShell/scripts/ping-host.ps1

34 lines
1.0 KiB
PowerShell
Raw Normal View History

2024-10-01 15:11:03 +02:00
<#
2024-03-23 11:57:48 +01:00
.SYNOPSIS
2024-11-04 15:08:49 +01:00
Pings a host
2024-03-23 11:57:48 +01:00
.DESCRIPTION
2024-11-04 15:08:49 +01:00
This PowerShell script pings the given host.
2024-03-23 11:57:48 +01:00
.PARAMETER hostname
2024-12-04 11:24:21 +01:00
Specifies the hostname or IP address to ping (x.com by default)
2024-03-23 11:57:48 +01:00
.EXAMPLE
2024-11-04 15:08:49 +01:00
PS> ./ping-host.ps1 x.com
2024-12-07 15:09:54 +01:00
Host 'x.com' is UP (20ms latency to IP 104.244.42.65).
2024-03-23 11:57:48 +01:00
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
2024-12-04 11:24:21 +01:00
param([string]$hostname = "x.com")
2024-03-23 11:57:48 +01:00
try {
2024-12-07 15:09:54 +01:00
$remoteHosts = $hostname.Split(",")
$tasks = $remoteHosts | foreach { (New-Object Net.NetworkInformation.Ping).SendPingAsync($_,3000) }
[Threading.Tasks.Task]::WaitAll($tasks)
foreach($ping in $tasks.Result) {
if ($ping.Status -eq "Success") {
Write-Host "✅ Host '$hostname' is UP ($($ping.RoundtripTime)ms latency to IP $($ping.Address))."
exit 0 # success
}
}
Write-Host "⚠️ Host '$hostname' doesn't respond - check the connection or maybe the host is down (yet)."
exit 1
2024-03-23 11:57:48 +01:00
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}