USB Enable Selective Suspend

<#
Disable-FTDI-SelectiveSuspend-ApplyIfMissing-WithPortName.ps1
- Only creates selective-suspend properties if they do not already exist.
- If any changes are made (and not -WhatIf), reboots the PC (15s countdown) so Windows picks up changes.
- If PortName is missing, attempts to detect the assigned COM (via Win32_SerialPort) and writes PortName so Device Manager Advanced shows the COM. Run as Administrator.
#> param( [switch]$WhatIf, # dry run: show what would change, do not write or reboot [switch]$NoReboot # if specified, do not reboot even when changes were made) # Ensure elevated
if (-not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) { Write-Error "Run this script in an elevated PowerShell (Run as Administrator). Exiting." exit 1
} $timestamp = (Get-Date).ToString('yyyyMMdd_HHmmss')
$logFile = Join-Path $env:USERPROFILE "Desktop\FTDI_ApplyIfMissing_$timestamp.log"
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 # Regex for detecting existing serial-enumerator-like properties (we only touch existing ones)
$serialEnumRegex = '(serial.*enum|enum.*serial|serialenumerator|enable.*serial)' # Trackers
$changedDevices = @
$skippedDevices = @
$errors = @ # Discover FTDI COM ports
$ports = Get-PnpDevice -Class Ports -PresentOnly -ErrorAction SilentlyContinue | Where-Object { ($_.Manufacturer -and $_.Manufacturer -like '*FTDI*') -or ($_.InstanceId -and $_.InstanceId -match 'VID_0403') } if (-not $ports -or $ports.Count -eq 0) { "No FTDI COM ports found." | Tee-Object -FilePath $logFile -Append Write-Output "No FTDI COM ports found. See log: $logFile" exit 0
} "Found $($ports.Count) FTDI COM port(s)." | Tee-Object -FilePath $logFile -Append # helper: find COM assigned to a PnP instance (tries exact match then tail-match)
function Get-ComForInstance { param($instanceId) # Try exact PNPDeviceID match in Win32_SerialPort try { $sp = Get-CimInstance -ClassName Win32_SerialPort -ErrorAction SilentlyContinue | Where-Object { $_.PNPDeviceID -eq $instanceId } if ($sp) { return $sp.DeviceID } # returns "COM3" etc. } catch { } # If exact match failed, try matching the last segment of InstanceId $tail = $instanceId.Split('\')[-1] try { $sp2 = Get-CimInstance -ClassName Win32_SerialPort -ErrorAction SilentlyContinue | Where-Object { $_.PNPDeviceID -like "*$tail*" } if ($sp2) { return $sp2[0].DeviceID } } catch { } # Fallback: try HARDWARE\DEVICEMAP\SERIALCOMM mapping (attempt to find a value that contains the tail) try { $map = Get-Item -Path 'HKLM:\HARDWARE\DEVICEMAP\SERIALCOMM' -ErrorAction SilentlyContinue if ($map) { $values = Get-ItemProperty -Path 'HKLM:\HARDWARE\DEVICEMAP\SERIALCOMM' -ErrorAction SilentlyContinue foreach ($name in ($values.PSObject.Properties | Where-Object { $_.Name -ne 'PSPath' -and $_.Name -ne 'PSParentPath' -and $_.Name -ne 'PSChildName' -and $_.Name -ne 'PSDrive' -and $_.Name -ne 'PSProvider' } | Select-Object -ExpandProperty Name) { $val = (Get-ItemProperty -Path 'HKLM:\HARDWARE\DEVICEMAP\SERIALCOMM' -Name $name -ErrorAction SilentlyContinue).$name if ($name -like "*$tail*" -or $val -like "COM*") { # best-effort: return the value found return $val } } } } catch { } return $null
} foreach ($p in $ports) { "----" | Tee-Object -FilePath $logFile -Append "FriendlyName: $($p.FriendlyName)" | Tee-Object -FilePath $logFile -Append "InstanceId: $($p.InstanceId)" | Tee-Object -FilePath $logFile -Append $inst = $p.InstanceId if ([string]::IsNullOrWhiteSpace($inst) { "InstanceId empty; skipping." | Tee-Object -FilePath $logFile -Append $skippedDevices += $inst continue } $base = "HKLM:\SYSTEM\CurrentControlSet\Enum\$inst" $dpCandidates = @( "$base\Device Parameters", "$base\0000\Device Parameters") $foundDP = $false $deviceWasChanged = $false foreach ($dp in $dpCandidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $foundDP = $true "Found Device Parameters: $dp" | Tee-Object -FilePath $logFile -Append # helper: check existence of a named property function Property-Exists { param($Path, $Name) try { $val = Get-ItemProperty -Path $Path -Name $Name -ErrorAction SilentlyContinue return ($null -ne $val) } catch { return $false } } # Only create if property does NOT exist $propsToEnsure = @{ 'DeviceIdleEnabled' = 0 'DefaultIdleState' = 0 'UserSetDeviceIdleEnabled' = 0 'SSIdleTimeout' = 0 } foreach ($kv in $propsToEnsure.GetEnumerator { $name = $kv.Key $desired = $kv.Value $exists = Property-Exists -Path $dp -Name $name if ($exists) { "$name already exists at $dp (skipping creation)." | Tee-Object -FilePath $logFile -Append } else { if ($WhatIf) { "WhatIf: would create $name = $desired at $dp" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } else { try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value $desired -Force -ErrorAction Stop | Out-Null "Created $name = $desired at $dp" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } catch { "ERROR creating $name at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "ERROR creating $name at $dp : $($_.Exception.Message)" } } } } # Disable any existing Serial Enumerator-like properties (only if they exist) try { $existingProps = (Get-ItemProperty -Path $dp -ErrorAction SilentlyContinue).PSObject.Properties | ForEach-Object { $_.Name } } catch { $existingProps = @ } foreach ($propName in $existingProps) { if ($propName -match $serialEnumRegex) { # read current value try { $curVal = Get-ItemProperty -Path $dp -Name $propName -ErrorAction SilentlyContinue | Select-Object -ExpandProperty $propName -ErrorAction SilentlyContinue } catch { $curVal = $null } if ($null -eq $curVal) { $curVal = $null } # treat missing as null if ($null -eq $curVal) { # property exists but no value? create as 0 if ($WhatIf) { "WhatIf: would set existing $propName = 0 at $dp (regex matched)" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } else { try { New-ItemProperty -Path $dp -Name $propName -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "Set existing $propName = 0 at $dp (regex matched)" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } catch { "ERROR writing $propName at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "ERROR writing $propName at $dp : $($_.Exception.Message)" } } } else { # existing numeric value: only change if it does not exist (user requested only create-if-missing), # so we will NOT overwrite. Log it and skip. "$propName exists with value $curVal at $dp (no overwrite per policy)." | Tee-Object -FilePath $logFile -Append } } } # --- PortName logic: ensure PortName exists and is not blank in Device Manager --- # Only create PortName if it does not exist or is empty, and if we can discover the COM $portExists = Property-Exists -Path $dp -Name 'PortName' $currentPortName = $null if ($portExists) { try { $currentPortName = (Get-ItemProperty -Path $dp -Name 'PortName' -ErrorAction SilentlyContinue).PortName } catch { $currentPortName = $null } } if (-not $portExists -or [string]::IsNullOrWhiteSpace($currentPortName) { # Try to discover COM assigned to this instance $detectedCOM = Get-ComForInstance -instanceId $inst if ($detectedCOM) { if ($WhatIf) { "WhatIf: would create PortName = $detectedCOM at $dp" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } else { try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name 'PortName' -PropertyType String -Value $detectedCOM -Force -ErrorAction Stop | Out-Null "Created PortName = $detectedCOM at $dp (so Device Manager will show COM)" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } catch { "ERROR writing PortName at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "ERROR writing PortName at $dp : $($_.Exception.Message)" } } } else { "Could not detect COM for instance $inst; will NOT write blank PortName." | Tee-Object -FilePath $logFile -Append } } else { "PortName already present ('$currentPortName') at $dp (no change)." | Tee-Object -FilePath $logFile -Append } break # exit candidates loop for this device } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $foundDP) { "Device Parameters not found for instance $inst. Skipping." | Tee-Object -FilePath $logFile -Append $skippedDevices += $inst } else { if ($deviceWasChanged) { $changedDevices += $inst } else { $skippedDevices += $inst } }
} # Summary logging
"=== Summary ===" | Tee-Object -FilePath $logFile -Append
"Devices changed: $($changedDevices.Count)" | Tee-Object -FilePath $logFile -Append
if ($changedDevices.Count -gt 0) { $changedDevices | Tee-Object -FilePath $logFile -Append } "Devices skipped/already-compliant: $($skippedDevices.Count)" | Tee-Object -FilePath $logFile -Append
if ($skippedDevices.Count -gt 0) { $skippedDevices | Tee-Object -FilePath $logFile -Append } if ($errors.Count -gt 0) { "Errors encountered: $($errors.Count)" | Tee-Object -FilePath $logFile -Append $errors | Tee-Object -FilePath $logFile -Append
} # Reboot if changes were made and not a dry run and not suppressed
if (($changedDevices.Count -gt 0) -and (-not $WhatIf) -and (-not $NoReboot) { "Changes applied. Rebooting in 15 seconds to apply changes..." | Tee-Object -FilePath $logFile -Append Write-Output "Changes applied. Rebooting in 15 seconds to apply changes..." Start-Process -FilePath "shutdown.exe" -ArgumentList "/r /t 15 /c `"`"Applying FTDI Device Parameter changes`"`"" -NoNewWindow
} else { if ($changedDevices.Count -eq 0) { "No updates were necessary. No reboot will be performed." | Tee-Object -FilePath $logFile -Append Write-Output "No updates were necessary." } else { "No reboot requested (NoReboot specified or WhatIf). Review log: $logFile" | Tee-Object -FilePath $logFile -Append Write-Output "Changes applied but reboot suppressed. Review log: $logFile" }
} "Completed: $(Get-Date -Format u)" | Tee-Object -FilePath $logFile -Append
Write-Output "Done. Log saved to: $logFile"

<#
Disable-FTDI-SelectiveSuspend-ApplyIfMissing.ps1
- Only creates selective-suspend properties if they do not already exist.
- If any changes are made (and not -WhatIf and not -NoReboot), reboots the PC with a 15s countdown so Windows picks up changes. Run as Administrator.
#> param( [switch]$WhatIf, # dry run: show what would change, do not write or reboot [switch]$NoReboot # if specified, do not reboot even when changes were made) # Ensure elevated
if (-not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) { Write-Error "Run this script in an elevated PowerShell (Run as Administrator). Exiting." exit 1
} $timestamp = (Get-Date).ToString('yyyyMMdd_HHmmss')
$logFile = Join-Path $env:USERPROFILE "Desktop\FTDI_ApplyIfMissing_$timestamp.log"
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 # Regex for detecting existing serial-enumerator-like properties (we only touch existing ones)
$serialEnumRegex = '(serial.*enum|enum.*serial|serialenumerator|enable.*serial)' # Trackers
$changedDevices = @
$skippedDevices = @
$errors = @ # Discover FTDI COM ports
$ports = Get-PnpDevice -Class Ports -PresentOnly -ErrorAction SilentlyContinue | Where-Object { ($_.Manufacturer -and $_.Manufacturer -like '*FTDI*') -or ($_.InstanceId -and $_.InstanceId -match 'VID_0403') } if (-not $ports -or $ports.Count -eq 0) { "No FTDI COM ports found." | Tee-Object -FilePath $logFile -Append Write-Output "No FTDI COM ports found. See log: $logFile" exit 0
} "Found $($ports.Count) FTDI COM port(s)." | Tee-Object -FilePath $logFile -Append foreach ($p in $ports) { "----" | Tee-Object -FilePath $logFile -Append "FriendlyName: $($p.FriendlyName)" | Tee-Object -FilePath $logFile -Append "InstanceId: $($p.InstanceId)" | Tee-Object -FilePath $logFile -Append $inst = $p.InstanceId if ([string]::IsNullOrWhiteSpace($inst) { "InstanceId empty; skipping." | Tee-Object -FilePath $logFile -Append $skippedDevices += $inst continue } # Build registry paths (safe direct interpolation) $base = "HKLM:\SYSTEM\CurrentControlSet\Enum\$inst" $dpCandidates = @( "$base\Device Parameters", "$base\0000\Device Parameters") $foundDP = $false $deviceWasChanged = $false foreach ($dp in $dpCandidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $foundDP = $true "Found Device Parameters: $dp" | Tee-Object -FilePath $logFile -Append # helper: check existence of a named property function Property-Exists { param($Path, $Name) try { $val = Get-ItemProperty -Path $Path -Name $Name -ErrorAction SilentlyContinue return ($null -ne $val) } catch { return $false } } # Only create if property does NOT exist $propsToEnsure = @{ 'DeviceIdleEnabled' = 0 'DefaultIdleState' = 0 'UserSetDeviceIdleEnabled' = 0 'SSIdleTimeout' = 0 } foreach ($kv in $propsToEnsure.GetEnumerator { $name = $kv.Key $desired = $kv.Value $exists = Property-Exists -Path $dp -Name $name if ($exists) { "$name already exists at $dp (skipping creation)." | Tee-Object -FilePath $logFile -Append } else { if ($WhatIf) { "WhatIf: would create $name = $desired at $dp" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } else { try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value $desired -Force -ErrorAction Stop | Out-Null "Created $name = $desired at $dp" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } catch { "ERROR creating $name at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "ERROR creating $name at $dp : $($_.Exception.Message)" } } } } # Disable any existing Serial Enumerator-like properties (only if they exist) try { $existingProps = (Get-ItemProperty -Path $dp -ErrorAction SilentlyContinue).PSObject.Properties | ForEach-Object { $_.Name } } catch { $existingProps = @ } foreach ($propName in $existingProps) { if ($propName -match $serialEnumRegex) { # read current value try { $curVal = Get-ItemProperty -Path $dp -Name $propName -ErrorAction SilentlyContinue | Select-Object -ExpandProperty $propName -ErrorAction SilentlyContinue } catch { $curVal = $null } if ($null -eq $curVal) { $curVal = $null } # treat missing as null if ($null -eq $curVal) { # property exists but no value? create as 0 if ($WhatIf) { "WhatIf: would set existing $propName = 0 at $dp (regex matched)" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } else { try { New-ItemProperty -Path $dp -Name $propName -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "Set existing $propName = 0 at $dp (regex matched)" | Tee-Object -FilePath $logFile -Append $deviceWasChanged = $true } catch { "ERROR writing $propName at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "ERROR writing $propName at $dp : $($_.Exception.Message)" } } } else { # existing numeric value: do NOT overwrite per policy; log and skip "$propName exists with value $curVal at $dp (no overwrite per policy)." | Tee-Object -FilePath $logFile -Append } } } break # exit candidates loop for this device } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $foundDP) { "Device Parameters not found for instance $inst. Skipping." | Tee-Object -FilePath $logFile -Append $skippedDevices += $inst } else { if ($deviceWasChanged) { $changedDevices += $inst } else { $skippedDevices += $inst } }
} # Summary logging
"=== Summary ===" | Tee-Object -FilePath $logFile -Append
"Devices changed: $($changedDevices.Count)" | Tee-Object -FilePath $logFile -Append
if ($changedDevices.Count -gt 0) { $changedDevices | Tee-Object -FilePath $logFile -Append } "Devices skipped/already-compliant: $($skippedDevices.Count)" | Tee-Object -FilePath $logFile -Append
if ($skippedDevices.Count -gt 0) { $skippedDevices | Tee-Object -FilePath $logFile -Append } if ($errors.Count -gt 0) { "Errors encountered: $($errors.Count)" | Tee-Object -FilePath $logFile -Append $errors | Tee-Object -FilePath $logFile -Append
} # Reboot if changes were made and not a dry run and not suppressed
if (($changedDevices.Count -gt 0) -and (-not $WhatIf) -and (-not $NoReboot) { "Changes applied. Rebooting in 15 seconds to apply changes..." | Tee-Object -FilePath $logFile -Append Write-Output "Changes applied. Rebooting in 15 seconds to apply changes..." Start-Process -FilePath 'shutdown.exe' -ArgumentList @('/r','/t','15','/c','Applying FTDI Device Parameter changes') -NoNewWindow
} else { if ($changedDevices.Count -eq 0) { "No updates were necessary. No reboot will be performed." | Tee-Object -FilePath $logFile -Append Write-Output "No updates were necessary." } else { "No reboot requested (NoReboot specified or WhatIf). Review log: $logFile" | Tee-Object -FilePath $logFile -Append Write-Output "Changes applied but reboot suppressed. Review log: $logFile" }
} "Completed: $(Get-Date -Format u)" | Tee-Object -FilePath $logFile -Append
Write-Output "Done. Log saved to: $logFile"
if (-not $WhatIf) { Write-Output "If you wrote values, Windows will pick them up after reboot (or run: pnputil /scan-devices)." }

if (-not (Test-Path $regPath) { New-Item -Path $regPath -Force | Out-Null }
New-ItemProperty -Path $regPath -Name 'DeviceIdleEnabled' -PropertyType DWord -Value 0 -Force
New-ItemProperty -Path $regPath -Name 'DefaultIdleState' -PropertyType DWord -Value 0 -Force
New-ItemProperty -Path $regPath -Name 'UserSetDeviceIdleEnabled' -PropertyType DWord -Value 0 -Force
New-ItemProperty -Path $regPath -Name 'SSIdleTimeout' -PropertyType DWord -Value 0 -Force
Write-Output "Wrote values for $inst"

 $tail = ($inst -split '\\')[-1] $matchTail = $portsWin | Where-Object { $_.PNPDeviceID -like "*$tail*" } if ($matchTail) { $matchTail | ForEach-Object { "Win32 SerialPort (tail match): DeviceID=$($_.DeviceID) PNPDeviceID=$($_.PNPDeviceID)" | Tee-Object -FilePath $log -Append } } else { "No Win32_SerialPort entry matched this instance." | Tee-Object -FilePath $log -Append }
}

$foundCom = $null
try { $sp = Get-CimInstance Win32_SerialPort -ErrorAction SilentlyContinue | Where-Object { $_.PNPDeviceID -eq $inst } if ($sp) { $foundCom = $sp.DeviceID } else { # try tail match $tail = $inst.Split('\')[-1] $sp2 = Get-CimInstance Win32_SerialPort -ErrorAction SilentlyContinue | Where-Object { $_.PNPDeviceID -like "*$tail*" } if ($sp2) { $foundCom = $sp2.DeviceID } }
} catch {}
if ($foundCom) { Ensure-Prop -Path $dp -Name 'PortName' -Type 'String' -Value $foundCom if ($changed) { "$inst -> PortName set to $foundCom" }
} else { "Could not detect COM for $inst; skipping PortName create."
}

 # Only create if missing $props = @{ 'DeviceIdleEnabled' = 0 'DefaultIdleState' = 0 'UserSetDeviceIdleEnabled' = 0 'SSIdleTimeout' = 0 } foreach ($kv in $props.GetEnumerator { $name = $kv.Key; $val = $kv.Value $exists = $false try { $exists = (Get-ItemProperty -Path $dp -Name $name -ErrorAction SilentlyContinue) -ne $null } catch { $exists = $false } if ($exists) { "$name exists — skipping" | Tee-Object -FilePath $log -Append } else { if ($WhatIf) { "WhatIf: would create $name = $val at $dp" | Tee-Object -FilePath $log -Append $changedCount++ } else { try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value $val -Force -ErrorAction Stop | Out-Null "Created $name = $val" | Tee-Object -FilePath $log -Append $changedCount++ } catch { "ERROR creating $name at $dp: $($_.Exception.Message)" | Tee-Object -FilePath $log -Append } } } } # If serial-enum props exist, set them to 0 (but do NOT create new unknown names) try { $existing = (Get-ItemProperty -Path $dp -ErrorAction SilentlyContinue).PSObject.Properties | ForEach-Object { $_.Name } } catch { $existing = @ } foreach ($nm in $existing) { if ($nm -match $serialEnumRegex) { # read current try { $cur = (Get-ItemProperty -Path $dp -Name $nm -ErrorAction SilentlyContinue).$nm } catch { $cur = $null } if ($null -eq $cur) { if ($WhatIf) { "WhatIf: would set existing $nm = 0 at $dp" | Tee-Object -FilePath $log -Append $changedCount++ } else { try { New-ItemProperty -Path $dp -Name $nm -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "Set $nm = 0" | Tee-Object -FilePath $log -Append $changedCount++ } catch { "ERROR writing $nm at $dp: $($_.Exception.Message)" | Tee-Object -FilePath $log -Append } } } else { "$nm exists with value $cur — not overwriting" | Tee-Object -FilePath $log -Append } } } break
} # Test-Path