PowerShell/docs/ping-hosts.md

*ping-hosts.ps1*
================

This PowerShell script pings well-known hostnames in the local network and lists which one up.

Parameters
----------
```powershell
PS> ./ping-hosts.ps1 [<CommonParameters>]

[<CommonParameters>]
    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```

Example
-------
```powershell
PS> ./check-hosts.ps1
✅ Up are: Hippo Jenkins01 Jenkins02 Rocket Vega

```

Notes
-----
Author: Markus Fleschutz | License: CC0

Related Links
-------------
https://github.com/fleschutz/PowerShell

Script Content
--------------
```powershell
<#
.SYNOPSIS
        Pings local hosts
.DESCRIPTION
        This PowerShell script pings well-known hostnames in the local network and lists which one up.
.EXAMPLE
        PS> ./check-hosts.ps1
	✅ Up are: Hippo Jenkins01 Jenkins02 Rocket Vega
.LINK
        https://github.com/fleschutz/PowerShell
.NOTES
        Author: Markus Fleschutz | License: CC0
#>

try {
	[string]$hosts = "Amnesiac,ArchLinux,Berlin,Boston,Brother,Canon,Castor,Cisco,EchoDot,Epson,Fedora,Fireball,Firewall,fritz.box,GasSensor,Gateway,Hippo,HomeManager,Io,iPhone,Jarvis,Jenkins01,Jenkins02,LA,Laptop,Jupiter,Mars,Mercury,Miami,Mobile,NY,OctoPi,Paris,Pixel-6a,Pluto,Printer,Proxy,R2D2,Raspberry,Rocket,Rome,Router,Server,Shelly1,SmartPhone,SmartWatch,Soundbar,Sunnyboy,Surface,Switch,Tablet,Tolino,TV,Ubuntu,Vega,Venus,XRX,Zeus" # sorted alphabetically
	[int]$timeout = 600 # milliseconds
	$hostsArray = $hosts.Split(",")
	$count = $hostsArray.Count

	Write-Progress "Sending pings to $count local hosts..."
        $queue = [System.Collections.Queue]::new()
	foreach($hostname in $hostsArray) {
		$ping = [System.Net.Networkinformation.Ping]::new()
		$object = @{ Host = $hostname; Ping = $ping; Async = $ping.SendPingAsync($hostname, $timeout) }
 		$queue.Enqueue($object)
        }

	[string]$result = ""
	while ($queue.Count -gt 0) {
		$object = $queue.Dequeue()
		try {
                	if ($object.Async.Wait($timeout) -eq $true) {
				if ($object.Async.Result.Status -ne "TimedOut") {
					$result += "$($object.Host) "
				}
				continue
			}
		} catch {
			if ($object.Async.IsCompleted -eq $true) {
				continue
			}
		}
		$queue.Enqueue($object)
	}
	Write-Progress -completed "Done."
	Write-Host "✅ Up are: $result"
	exit 0 # success
} catch {
        "⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
        exit 1
}
```

*(generated by convert-ps2md.ps1 using the comment-based help of ping-hosts.ps1 as of 12/16/2023 10:12:25)*