Wake-On-Lan Support

[marvinlehmann]

Hi,
I think it would be nice to have a function for enabling/disabling wake-on-lan. =)

Settings for Wake-On-Lan

0. Enabling it in BIOS/UEFI

1. Disabling fast startup and/or hibernation

Turning off fast startup:

New-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Power" -Name HiberbootEnabled -PropertyType DWord -Value 0 -Force

Disabling hibernation, which disables the former too (?):

Sophia-Script-for-Windows/Sophia Script/Sophia Script for Windows 10 PowerShell 7/Module/Sophia.psm1

Lines 4003 to 4055 in cb9af2a

	<#
	.SYNOPSIS
	Hibernation
	.PARAMETER Disable
	Disable hibernation
	.PARAMETER Enable
	Enable hibernation
	.EXAMPLE
	Hibernation -Enable
	.EXAMPLE
	Hibernation -Disable
	.NOTES
	Do not recommend turning it off on laptops
	.NOTES
	Current user
	#>
	function Hibernation
	{
	param
	(
	[Parameter(
	Mandatory = $true,
	ParameterSetName = "Disable"
	)]
	[switch]
	$Disable,
	[Parameter(
	Mandatory = $true,
	ParameterSetName = "Enable"
	)]
	[switch]
	$Enable
	)
	switch ($PSCmdlet.ParameterSetName)
	{
	"Disable"
	{
	POWERCFG /HIBERNATE OFF
	}
	"Enable"
	{
	POWERCFG /HIBERNATE ON
	}
	}
	}

2. NIC Power Management

2.1: Checking "Allow the computer to turn off this device to save power" ✅

Sophia-Script-for-Windows/Sophia Script/Sophia Script for Windows 10 PowerShell 7/Module/Sophia.psm1

Lines 5572 to 5634 in cb9af2a

	<#
	.SYNOPSIS
	Network adapters power management
	.PARAMETER Disable
	Do not allow the computer to turn off the network adapters to save power
	.PARAMETER Enable
	Allow the computer to turn off the network adapters to save power
	.EXAMPLE
	NetworkAdaptersSavePower -Disable
	.EXAMPLE
	NetworkAdaptersSavePower -Enable
	.NOTES
	Do not recommend turning it on on laptops
	.NOTES
	Current user
	#>
	function NetworkAdaptersSavePower
	{
	param
	(
	[Parameter(
	Mandatory = $true,
	ParameterSetName = "Disable"
	)]
	[switch]
	$Disable,
	[Parameter(
	Mandatory = $true,
	ParameterSetName = "Enable"
	)]
	[switch]
	$Enable
	)
	$Adapters = Get-NetAdapter -Physical | Get-NetAdapterPowerManagement | Where-Object -FilterScript {$_.AllowComputerToTurnOffDevice -ne "Unsupported"}
	switch ($PSCmdlet.ParameterSetName)
	{
	"Disable"
	{
	foreach ($Adapter in $Adapters)
	{
	$Adapter.AllowComputerToTurnOffDevice = "Disabled"
	$Adapter | Set-NetAdapterPowerManagement
	}
	}
	"Enable"
	{
	foreach ($Adapter in $Adapters)
	{
	$Adapter.AllowComputerToTurnOffDevice = "Enabled"
	$Adapter | Set-NetAdapterPowerManagement
	}
	}
	}
	}

2.2: Checking "Allow this device to wake the computer" ✅

$PnPDeviceID = Get-NetAdapter -Physical | Where-Object { $_.PhysicalMediaType -eq "802.3" }
  | Select-Object -First 1 -ExpandProperty PnPDeviceID # only getting first one here for illustration...

Get-CimInstance -ClassName MSPower_DeviceWakeEnable -Namespace root/wmi
  | Where-Object { $_.InstanceName -Match [regex]::escape($PnPDeviceID) }
    | Set-CimInstance -Property @{Enable=$True}

2.3: Checking "Only allow a magic packet to wake the computer" ✅

$PnPDeviceID = Get-NetAdapter -Physical | Where-Object { $_.PhysicalMediaType -eq "802.3" }
  | Select-Object -First 1 -ExpandProperty PnPDeviceID # only getting first one here for illustration...

Get-CimInstance -ClassName MSNdis_DeviceWakeOnMagicPacketOnly -Namespace root/wmi
  | Where-Object { $_.InstanceName -Match [regex]::escape($PnPDeviceID) }
    | Set-CimInstance -Property @{EnableWakeOnMagicPacketOnly=$true}

3. Advanced NetAdapter Properties

• EnablePME (Intel also calls it "Wake on Magic Packet from power off state"): Enabled
• Wake on Magic Packet: Enabled
• Wake on Pattern Match: Enabled
• Energy Efficient Ethernet: Disabled? (mentioned in some instructions e.g. by DELL - for me it didn't matter)

$Adapter | Set-NetAdapterPowerManagement -WakeOnMagicPacket Enabled
$Adapter | Set-NetAdapterPowerManagement -WakeOnPattern Enabled
$Adapter | Set-NetAdapterAdvancedProperty -RegistryKeyword EnablePME -RegistryValue 1
# wasn't needed for me:
$Adapter | Set-NetAdapterAdvancedProperty -RegistryKeyword EEELinkAdvertisement -RegistryValue 0 

[farag2]

🤔

[mrmattipants]

Great minds think alike ;)

[farag2]

😹