extern/PowerShell
1
0
Fork 0
mirror of https://github.com/fleschutz/PowerShell.git synced 2025-08-15 23:28:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

Updated the Markdown manuals

Browse Source
This commit is contained in:
Markus Fleschutz
2023-12-07 20:24:45 +01:00
parent dafa6cf1d7
commit 1ffd91c5e2
605 changed files with 1927 additions and 1015 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
docs/wake-up.md
View File

@ -6,9 +6,9 @@ This PowerShell script sends a magic UDP packet to a computer to wake him up (re
Parameters
----------
```powershell
PS> ./wake-up.ps1 [[-MACaddress] <String>] [[-IPaddress] <String>] [[-Port] <Int32>] [[-NumRetries] <Int32>] [<CommonParameters>]
PS> ./wake-up.ps1 [[-macAddr] <String>] [[-ipAddr] <String>] [[-udpPort] <Int32>] [[-numTimes] <Int32>] [<CommonParameters>]
-MACaddress <String>
-macAddr <String>
Specifies the host's MAC address (e.g. 11:22:33:44:55:66)
Required? false
@ -17,7 +17,7 @@ PS> ./wake-up.ps1 [[-MACaddress] <String>] [[-IPaddress] <String>] [[-Port] <Int
Accept pipeline input? false
Accept wildcard characters? false
-IPaddress <String>
-ipAddr <String>
Specifies the host's IP address or subnet address (e.g. 192.168.0.255)
Required? false
@ -26,7 +26,7 @@ PS> ./wake-up.ps1 [[-MACaddress] <String>] [[-IPaddress] <String>] [[-Port] <Int
Accept pipeline input? false
Accept wildcard characters? false
-Port <Int32>
-udpPort <Int32>
Specifies the UDP port (9 by default)
Required? false
@ -35,8 +35,8 @@ PS> ./wake-up.ps1 [[-MACaddress] <String>] [[-IPaddress] <String>] [[-Port] <Int
Accept pipeline input? false
Accept wildcard characters? false
-NumRetries <Int32>
Specifies number of retries (3 by default)
-numTimes <Int32>
Specifies # of times to send the packet (3 by default)
Required? false
Position? 4
@ -53,6 +53,7 @@ Example
-------
```powershell
PS> ./wake-up.ps1 11:22:33:44:55:66 192.168.100.100
✔️ Sent magic packet to IP 192.168.100.100, UDP port 9 (3 times). Wait a minute until the computer fully boots up.
```
@ -72,47 +73,46 @@ Script Content
Wakes up a computer using Wake-on-LAN
.DESCRIPTION
This PowerShell script sends a magic UDP packet to a computer to wake him up (requires the target computer to have Wake-on-LAN activated).
.PARAMETER MACaddress
.PARAMETER macAddr
Specifies the host's MAC address (e.g. 11:22:33:44:55:66)
.PARAMETER IPaddress
.PARAMETER ipAddr
Specifies the host's IP address or subnet address (e.g. 192.168.0.255)
.PARAMETER Port
.PARAMETER udpPort
Specifies the UDP port (9 by default)
.PARAMETER NumRetries
Specifies number of retries (3 by default)
.PARAMETER numTimes
Specifies # of times to send the packet (3 by default)
.EXAMPLE
PS> ./wake-up.ps1 11:22:33:44:55:66 192.168.100.100
✔️ Sent magic packet to IP 192.168.100.100, UDP port 9 (3 times). Wait a minute until the computer fully boots up.
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
param([string]$MACaddress = "", [string]$IPaddress = "", [int]$Port=9, [int]$NumRetries=3)
param([string]$macAddr = "", [string]$ipAddr = "", [int]$udpPort = 9, [int]$numTimes = 3)
function Send-WOL { param([string]$mac, [string]$ip, [int]$port)
$broadcast = [Net.IPAddress]::Parse($ip)
function Send-WOL { param([string]$macAddr, [string]$ipAddr, [int]$udpPort)
$broadcastAddr = [Net.IPAddress]::Parse($ipAddr)
$mac=(($mac.replace(":","")).replace("-","")).replace(".","")
$target=0,2,4,6,8,10 | % {[convert]::ToByte($mac.substring($_,2),16)}
$macAddr = (($macAddr.replace(":","")).replace("-","")).replace(".","")
$target = 0,2,4,6,8,10 | % {[convert]::ToByte($macAddr.substring($_,2),16)}
$packet = (,[byte]255 * 6) + ($target * 16)
$UDPclient = new-Object System.Net.Sockets.UdpClient
$UDPclient.Connect($broadcast,$port)
$UDPclient = New-Object System.Net.Sockets.UdpClient
$UDPclient.Connect($broadcastAddr, $udpPort)
[void]$UDPclient.Send($packet, 102)
}
try {
if ($MACaddress -eq "" ) { $MACaddress = Read-Host "Enter the host's MAC address, e.g. 11:22:33:44:55:66" }
if ($IPaddress -eq "" ) { $IPaddress = Read-Host "Enter the host's IP or subnet address, e.g. 192.168.0.255" }
if ($macAddr -eq "" ) { $macAddr = Read-Host "Enter the host's MAC address, e.g. 11:22:33:44:55:66" }
if ($ipAddr -eq "" ) { $ipAddr = Read-Host "Enter the host's IP or subnet address, e.g. 192.168.0.255" }
Send-WOL $MACaddress $IPaddress $Port
for ($i = 0; $i -lt $NumRetries; $i++) {
Start-Sleep -milliseconds 100
Send-WOL $MACaddress $IPaddress $Port
for ($i = 0; $i -lt $numTimes; $i++) {
Send-WOL $macAddr $ipAddr $udpPort
Start-Sleep -milliseconds 100
}
"✔️ sent magic packet with MAC $MACaddress to IP $IPaddress on port $Port as wakeup call ($($NumRetries + 1) times)"
" (Hint: wait a minute until the computer fully boots up)"
"✔️ Sent magic packet to IP $ipAddr, UDP port $udpPort ($numTimes times). Wait a minute until the computer fully boots up."
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
@ -120,4 +120,4 @@ try {
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of wake-up.ps1 as of 10/19/2023 08:11:43)*
*(generated by convert-ps2md.ps1 using the comment-based help of wake-up.ps1 as of 12/07/2023 20:24:24)*