PowerShell/docs/ping-local-hosts.md

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

This PowerShell script pings the computers in the local network and lists which one are up.

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

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

Example
-------
```powershell
PS> ./ping-local-hosts.ps1
✅ Hippo Jenkins01 Jenkins02 Rocket Vega are up.

```

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 the computers in the local network and lists which one are up.
.EXAMPLE
        PS> ./ping-local-hosts.ps1
	✅ Hippo Jenkins01 Jenkins02 Rocket Vega are up.
.LINK
        https://github.com/fleschutz/PowerShell
.NOTES
        Author: Markus Fleschutz | License: CC0
#>

try {
	Write-Progress "Sending pings to the local hosts..."
	[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
	$hostsArray = $hosts.Split(",")
	$count = $hostsArray.Count

	[int]$timeout = 600 # ms
        $queue = [System.Collections.Queue]::new()
	foreach($hostname in $hostsArray) {
		$ping = [System.Net.Networkinformation.Ping]::new()
		$obj = @{ Host = $hostname; Ping = $ping; Async = $ping.SendPingAsync($hostname, $timeout) }
 		$queue.Enqueue($obj)
        }

	[string]$result = ""
	while ($queue.Count -gt 0) {
		$obj = $queue.Dequeue()
		try {
                	if ($obj.Async.Wait($timeout) -eq $true) {
				if ($obj.Async.Result.Status -ne "TimedOut") {
					$result += "$($obj.Host) "
				}
				continue
			}
		} catch {
			if ($obj.Async.IsCompleted -eq $true) {	continue }
		}
		$queue.Enqueue($obj)
	}
	Write-Progress -completed "Done."
	Write-Host "✅ $($result)are up."
	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-local-hosts.ps1 as of 01/03/2024 12:10:50)*