Updated the Markdown manuals

docs/ping-remote-hosts.md

@@ -0,0 +1,93 @@
+*ping-remote-hosts.ps1*
+================
+
+This PowerShell script measures the ping roundtrip times from the local computer to remote ones (10 Internet servers by default).
+
+Parameters
+----------
+```powershell
+PS> ./ping-remote-hosts.ps1 [[-hosts] <String>] [<CommonParameters>]
+
+-hosts <String>
+    Specifies the hosts to ping, seperated by commata (10 Internet servers by default)
+    
+    Required?                    false
+    Position?                    1
+    Default value                bing.com,cnn.com,dropbox.com,github.com,google.com,ibm.com,live.com,meta.com,x.com,youtube.com
+    Accept pipeline input?       false
+    Accept wildcard characters?  false
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+Example
+-------
+```powershell
+PS> ./ping-remote-hosts.ps1
+✅ Online with 18ms latency (13ms...109ms, 0/10 ping loss)
+
+```
+
+Notes
+-----
+Author: Markus Fleschutz | License: CC0
+
+Related Links
+-------------
+https://github.com/fleschutz/PowerShell
+
+Script Content
+--------------
+```powershell
+<#
+.SYNOPSIS
+	Pings remote hosts to measure the latency 
+.DESCRIPTION
+	This PowerShell script measures the ping roundtrip times from the local computer to remote ones (10 Internet servers by default).
+.PARAMETER hosts
+	Specifies the hosts to ping, seperated by commata (10 Internet servers by default)
+.EXAMPLE
+	PS> ./ping-remote-hosts.ps1
+	✅ Online with 18ms latency (13ms...109ms, 0/10 ping loss)
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([string]$hosts = "bing.com,cnn.com,dropbox.com,github.com,google.com,ibm.com,live.com,meta.com,x.com,youtube.com")
+
+try {
+	$hostsArray = $hosts.Split(",")
+	$parallelTasks = $hostsArray | foreach {
+		(New-Object Net.NetworkInformation.Ping).SendPingAsync($_,750)
+	}
+	[int]$min = 9999999
+	[int]$max = [int]$avg = [int]$success = 0
+	[int]$total = $hostsArray.Count
+	[Threading.Tasks.Task]::WaitAll($parallelTasks)
+	foreach($ping in $parallelTasks.Result) {
+		if ($ping.Status -ne "Success") { continue }
+		$success++
+		[int]$latency = $ping.RoundtripTime
+		$avg += $latency
+		if ($latency -lt $min) { $min = $latency }
+		if ($latency -gt $max) { $max = $latency }
+	}
+	[int]$loss = $total - $success
+	if ($success -ne 0) {
+		$avg /= $success
+		Write-Host "✅ Online with $($avg)ms latency ($($min)ms...$($max)ms, $loss/$total ping loss)"
+	} else {
+		Write-Host "⚠️ Offline ($loss/$total ping loss)"
+	}
+	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-remote-hosts.ps1 as of 01/03/2024 12:10:50)*