USB Enable Selective Suspend

try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name 'DeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop New-ItemProperty -Path $dp -Name 'DefaultIdleState' -PropertyType DWord -Value 0 -Force -ErrorAction Stop New-ItemProperty -Path $dp -Name 'UserSetDeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop New-ItemProperty -Path $dp -Name 'SSIdleTimeout' -PropertyType DWord -Value 0 -Force -ErrorAction Stop Add-Content $log "WROTE values at $dp"
} catch { Add-Content $log "ERROR writing values at $dp : $($_.Exception.Message)"
}

<#
.SYNOPSIS Disable selective-suspend settings (per-device) for FTDI COM ports by writing Device Parameters under Enum. .DESCRIPTION Finds FTDI COM ports and writes DeviceIdleEnabled, DefaultIdleState, UserSetDeviceIdleEnabled and SSIdleTimeout = 0 into each device's HKLM:\SYSTEM\CurrentControlSet\Enum\<instance>\Device Parameters or ...\0000\Device Parameters. Produces a log on the current user's Desktop. .NOTES Run as Administrator. Editing HKLM\SYSTEM\CurrentControlSet\Enum requires elevation and may be blocked by ACLs. If you get "Access denied" for Enum keys, reply and I will provide next steps (ownership/ACL alternatives or INF approach). .PARAMETER WhatIf If specified, the script will not write registry values; it will only log what it would do. .EXAMPLE # Dry run .\Set-FTDI-DisableSelectiveSuspend.ps1 -WhatIf # Apply .\Set-FTDI-DisableSelectiveSuspend.ps1
#> param( [switch]$WhatIf) function Assert-Elevated { $isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) if (-not $isAdmin) { Write-Error "This script must be run as Administrator. Right-click PowerShell and choose 'Run as administrator'. Exiting." exit 1 }
} Assert-Elevated $logFile = Join-Path $env:USERPROFILE ("Desktop\FTDI_DisableSelectiveSuspend_{0}.log" -f (Get-Date -Format 'yyyyMMdd_HHmmss')
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 try { # Discover FTDI ports (both by Manufacturer and by VID) $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 by Get-PnpDevice -Class Ports." | Tee-Object -FilePath $logFile -Append "Try: Get-PnpDevice -PresentOnly -Class USB | Where-Object { \$_.InstanceId -match 'VID_0403' }" | Tee-Object -FilePath $logFile -Append throw "No FTDI COM ports found. Exiting." } "Found $($ports.Count) FTDI 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 is empty or null; skipping." | Tee-Object -FilePath $logFile -Append continue } # Build the registry Enum base path robustly $enumBase = 'HKLM:\SYSTEM\CurrentControlSet\Enum' $parts = $inst -split '\\' # split on literal backslash $sub = $parts -join '\' # re-join safely $regPathBase = Join-Path $enumBase $sub # Candidate Device Parameters locations (common variants) $candidates = @( Join-Path $regPathBase 'Device Parameters', Join-Path $regPathBase '0000\Device Parameters') $found = $false foreach ($dp in $candidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $found = $true "FOUND Device Parameters at: $dp" | Tee-Object -FilePath $logFile -Append # Read current properties (if any) try { $curr = Get-ItemProperty -Path $dp -ErrorAction Stop $sel = @{ DeviceIdleEnabled = $curr.DeviceIdleEnabled; DefaultIdleState = $curr.DefaultIdleState; UserSetDeviceIdleEnabled = $curr.UserSetDeviceIdleEnabled; SSIdleTimeout = $curr.SSIdleTimeout } "Current values: $($sel | ConvertTo-Json -Depth 2)" | Tee-Object -FilePath $logFile -Append } catch { "Could not read properties at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } if ($WhatIf) { "WhatIf: would write DeviceIdleEnabled=0, DefaultIdleState=0, UserSetDeviceIdleEnabled=0, SSIdleTimeout=0 at $dp" | Tee-Object -FilePath $logFile -Append } else { try { # Ensure key exists and write values New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name 'DeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'DefaultIdleState' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'UserSetDeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'SSIdleTimeout' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE values at $dp" | Tee-Object -FilePath $logFile -Append } catch { "ERROR writing values at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } break # stop checking candidates for this device } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $found) { "Device Parameters not found under $regPathBase. Listing up to 50 child keys for diagnosis:" | Tee-Object -FilePath $logFile -Append try { Get-ChildItem -Path $regPathBase -Recurse -Depth 2 -ErrorAction Stop | Select-Object -First 50 | ForEach-Object { $_.PSPath } | Tee-Object -FilePath $logFile -Append } catch { "Could not enumerate $regPathBase : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } # Suggest rescan if we performed changes if (-not $WhatIf) { "If you applied changes, run 'pnputil /scan-devices' or reboot to have Windows pick up the new values." | Tee-Object -FilePath $logFile -Append } else { "Dry run completed (WhatIf). No registry writes performed." | Tee-Object -FilePath $logFile -Append } } catch { "Unhandled error: $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append throw
} finally { "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, run: pnputil /scan-devices (or reboot) and then check the COM port Advanced → Serial Enumerator state in Device Manager." }

<#
.SYNOPSIS Disable per-device selective-suspend and disable Serial Enumerator-like properties for FTDI COM ports. .DESCRIPTION Finds FTDI COM ports and writes DeviceIdleEnabled, DefaultIdleState, UserSetDeviceIdleEnabled and SSIdleTimeout = 0 into each device's HKLM:\SYSTEM\CurrentControlSet\Enum\<instance>\Device Parameters (or ...\0000\Device Parameters). Also detects property names that look like "Serial Enumerator" and sets them = 0 (creates if missing). Produces a log on the current user's Desktop. .PARAMETER WhatIf If specified, the script will not write registry values; it will only log what it would do. .EXAMPLE # Dry run .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator.ps1 -WhatIf # Apply .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator.ps1
#> param( [switch]$WhatIf) function Assert-Elevated { $isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) if (-not $isAdmin) { Write-Error "This script must be run as Administrator. Right-click PowerShell and choose 'Run as administrator'. Exiting." exit 1 }
} Assert-Elevated $logFile = Join-Path $env:USERPROFILE ("Desktop\FTDI_DisableSelectiveSuspend_SerialEnum_{0}.log" -f (Get-Date -Format 'yyyyMMdd_HHmmss')
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 # Explicit names we will set (if present) and names to try creating
$explicitSerialNames = @( 'SerialEnumerator','EnableSerialEnumerator','SerialEnum','SerialEnumerate','SerialEnumer','EnableSerialEnumer','SerialEnumeratorEnabled') # Regex to detect vendor-specific property names containing serial + enum (loose)
$serialEnumRegex = '(serial.*enum|enum.*serial|serialenumerator|enable.*serial)' try { # Discover FTDI ports (both by Manufacturer and by VID) $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 by Get-PnpDevice -Class Ports." | Tee-Object -FilePath $logFile -Append "Try: Get-PnpDevice -PresentOnly -Class USB | Where-Object { \$_.InstanceId -match 'VID_0403' }" | Tee-Object -FilePath $logFile -Append throw "No FTDI COM ports found. Exiting." } "Found $($ports.Count) FTDI 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 is empty or null; skipping." | Tee-Object -FilePath $logFile -Append continue } # Build the registry Enum base path robustly $enumBase = 'HKLM:\SYSTEM\CurrentControlSet\Enum' $parts = $inst -split '\\' $sub = $parts -join '\' $regPathBase = Join-Path $enumBase $sub # Candidate Device Parameters locations $candidates = @( Join-Path $regPathBase 'Device Parameters', Join-Path $regPathBase '0000\Device Parameters') $found = $false foreach ($dp in $candidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $found = $true "FOUND Device Parameters at: $dp" | Tee-Object -FilePath $logFile -Append # Read current properties (if any) try { $curr = Get-ItemProperty -Path $dp -ErrorAction Stop # capture some known keys plus list all property names for detection $currProps = $curr.PSObject.Properties | ForEach-Object { $_.Name } $sel = @{ DeviceIdleEnabled = ($curr.DeviceIdleEnabled -as [int]); DefaultIdleState = ($curr.DefaultIdleState -as [int]); UserSetDeviceIdleEnabled = ($curr.UserSetDeviceIdleEnabled -as [int]); SSIdleTimeout = ($curr.SSIdleTimeout -as [int]); AllProperties = $currProps } "Current values: $($sel | ConvertTo-Json -Depth 3)" | Tee-Object -FilePath $logFile -Append } catch { "Could not read properties at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $currProps = @ } if ($WhatIf) { "WhatIf: would write DeviceIdleEnabled=0, DefaultIdleState=0, UserSetDeviceIdleEnabled=0, SSIdleTimeout=0 at $dp" | Tee-Object -FilePath $logFile -Append } else { try { # Ensure key exists and write values New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name 'DeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'DefaultIdleState' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'UserSetDeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'SSIdleTimeout' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE selective-suspend values at $dp" | Tee-Object -FilePath $logFile -Append } catch { "ERROR writing selective-suspend values at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } # ---- Serial Enumerator detection + write ---- # 1) Explicit names: set any of the common names if present (or create them) foreach ($name in $explicitSerialNames) { if ($WhatIf) { "WhatIf: would set $name = 0 at $dp (explicit list)" | Tee-Object -FilePath $logFile -Append } else { try { New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE $name = 0 at $dp (explicit list)" | Tee-Object -FilePath $logFile -Append } catch { "Failed to write $name at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } # 2) Regex-based detection among existing property names (do not create arbitrary unknown names unless explicit) $matched = @ foreach ($propName in $currProps) { if ($propName -match $serialEnumRegex) { $matched += $propName } } if ($matched.Count -gt 0) { foreach ($m in $matched) { if ($WhatIf) { "WhatIf: would set detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append } else { try { New-ItemProperty -Path $dp -Name $m -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append } catch { "Failed to write detected property $m at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } } else { "No existing properties matched serial/enum regex at $dp." | Tee-Object -FilePath $logFile -Append } break # stop checking candidates for this device } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $found) { "Device Parameters not found under $regPathBase. Listing up to 50 child keys for diagnosis:" | Tee-Object -FilePath $logFile -Append try { Get-ChildItem -Path $regPathBase -Recurse -Depth 2 -ErrorAction Stop | Select-Object -First 50 | ForEach-Object { $_.PSPath } | Tee-Object -FilePath $logFile -Append } catch { "Could not enumerate $regPathBase : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } # Suggest rescan if we performed changes if (-not $WhatIf) { "If you applied changes, run 'pnputil /scan-devices' or reboot to have Windows pick up the new values." | Tee-Object -FilePath $logFile -Append } else { "Dry run completed (WhatIf). No registry writes performed." | Tee-Object -FilePath $logFile -Append } } catch { "Unhandled error: $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append throw
} finally { "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, run: pnputil /scan-devices (or reboot) and then check the COM port Advanced → Serial Enumerator state in Device Manager." }

<#
Disable per-device selective-suspend and disable Serial Enumerator-like properties for FTDI COM ports.
Run as Administrator.
#> param( [switch]$WhatIf) function Assert-Elevated { $isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) if (-not $isAdmin) { Write-Error "This script must be run as Administrator. Right-click PowerShell and choose 'Run as administrator'. Exiting." exit 1 }
} Assert-Elevated $logFile = Join-Path $env:USERPROFILE ("Desktop\FTDI_DisableSelectiveSuspend_SerialEnum_{0}.log" -f (Get-Date -Format 'yyyyMMdd_HHmmss')
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 $explicitSerialNames = @( 'SerialEnumerator','EnableSerialEnumerator','SerialEnum','SerialEnumerate','SerialEnumer','EnableSerialEnumer','SerialEnumeratorEnabled')
$serialEnumRegex = '(serial.*enum|enum.*serial|serialenumerator|enable.*serial)' try { $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 by Get-PnpDevice -Class Ports." | Tee-Object -FilePath $logFile -Append throw "No FTDI COM ports found. Exiting." } "Found $($ports.Count) FTDI 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 is empty or null; skipping." | Tee-Object -FilePath $logFile -Append continue } $enumBase = 'HKLM:\SYSTEM\CurrentControlSet\Enum' # Ensure $sub is a single string $parts = $inst -split '\\' $sub = [string]($parts -join '\') $regPathBase = Join-Path $enumBase $sub # Build candidate Device Parameters paths safely $candidates = @ $candidates += Join-Path $regPathBase 'Device Parameters' $candidates += Join-Path (Join-Path $regPathBase '0000') 'Device Parameters' $found = $false foreach ($dp in $candidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $found = $true "FOUND Device Parameters at: $dp" | Tee-Object -FilePath $logFile -Append try { $curr = Get-ItemProperty -Path $dp -ErrorAction Stop $currProps = $curr.PSObject.Properties | ForEach-Object { $_.Name } $sel = @{ DeviceIdleEnabled = ($curr.DeviceIdleEnabled -as [int]); DefaultIdleState = ($curr.DefaultIdleState -as [int]); UserSetDeviceIdleEnabled = ($curr.UserSetDeviceIdleEnabled -as [int]); SSIdleTimeout = ($curr.SSIdleTimeout -as [int]); AllProperties = $currProps } "Current values: $($sel | ConvertTo-Json -Depth 3)" | Tee-Object -FilePath $logFile -Append } catch { "Could not read properties at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $currProps = @ } if ($WhatIf) { "WhatIf: would write DeviceIdleEnabled=0, DefaultIdleState=0, UserSetDeviceIdleEnabled=0, SSIdleTimeout=0 at $dp" | Tee-Object -FilePath $logFile -Append } else { try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name 'DeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'DefaultIdleState' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'UserSetDeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'SSIdleTimeout' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE selective-suspend values at $dp" | Tee-Object -FilePath $logFile -Append } catch { "ERROR writing selective-suspend values at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } # Explicit names: create/set them to 0 foreach ($name in $explicitSerialNames) { if ($WhatIf) { "WhatIf: would set $name = 0 at $dp (explicit list)" | Tee-Object -FilePath $logFile -Append } else { try { New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE $name = 0 at $dp (explicit list)" | Tee-Object -FilePath $logFile -Append } catch { "Failed to write $name at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } # Regex detection among existing property names $matched = @ foreach ($propName in $currProps) { if ($propName -match $serialEnumRegex) { $matched += $propName } } if ($matched.Count -gt 0) { foreach ($m in $matched) { if ($WhatIf) { "WhatIf: would set detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append } else { try { New-ItemProperty -Path $dp -Name $m -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append } catch { "Failed to write detected property $m at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } } else { "No existing properties matched serial/enum regex at $dp." | Tee-Object -FilePath $logFile -Append } break } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $found) { "Device Parameters not found under $regPathBase. Listing up to 50 child keys for diagnosis:" | Tee-Object -FilePath $logFile -Append try { Get-ChildItem -Path $regPathBase -Recurse -Depth 2 -ErrorAction Stop | Select-Object -First 50 | ForEach-Object { $_.PSPath } | Tee-Object -FilePath $logFile -Append } catch { "Could not enumerate $regPathBase : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } if (-not $WhatIf) { "If you applied changes, run 'pnputil /scan-devices' or reboot to have Windows pick up the new values." | Tee-Object -FilePath $logFile -Append } else { "Dry run completed (WhatIf). No registry writes performed." | Tee-Object -FilePath $logFile -Append } } catch { "Unhandled error: $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append throw
} finally { "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, run: pnputil /scan-devices (or reboot) and then check the COM port Advanced → Serial Enumerator state in Device Manager." }

<#
Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 Usage (run elevated): # Dry run .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 -WhatIf # Apply and assign COMs sequentially starting at COM10 .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 -StartCom 10 # Apply and attempt to force all FTDI devices to COM5 (may conflict) .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 -ForceCom 'COM5' -Override Parameters: -WhatIf : dry run, no registry writes -StartCom : integer, starting COM number (will increment per device) -ForceCom : string "COMn" to set that exact COM name for each device -Override : if specified, allow overriding existing COM owners (use with caution)
#> param( [switch]$WhatIf, [int]$StartCom, [string]$ForceCom, [switch]$Override) function Assert-Elevated { $isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) if (-not $isAdmin) { Write-Error "This script must be run as Administrator. Right-click PowerShell and choose 'Run as administrator'. Exiting." exit 1 }
}
Assert-Elevated $logFile = Join-Path $env:USERPROFILE ("Desktop\FTDI_Update_COM_and_Power_{0}.log" -f (Get-Date -Format 'yyyyMMdd_HHmmss')
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 # Explicit serial-enumerator property names to create if desired
$explicitSerialNames = @( 'SerialEnumerator','EnableSerialEnumerator','SerialEnum','SerialEnumerate','SerialEnumer','EnableSerialEnumer','SerialEnumeratorEnabled')
$serialEnumRegex = '(serial.*enum|enum.*serial|serialenumerator|enable.*serial)' # Helper: check if COM name in use (returns array of DeviceIDs using that COM)
function Get-ComOwners { param($comName) # Query Win32_SerialPort DeviceID (COMx) try { $owners = Get-CimInstance -ClassName Win32_SerialPort -ErrorAction SilentlyContinue | Where-Object { $_.DeviceID -eq $comName } return $owners } catch { return @ }
} # Discover FTDI ports
try { $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 by Get-PnpDevice -Class Ports." | Tee-Object -FilePath $logFile -Append throw "No FTDI COM ports found. Exiting." } "Found $($ports.Count) FTDI port(s)." | Tee-Object -FilePath $logFile -Append # Prepare COM assignment counters $nextCom = if ($PSBoundParameters.ContainsKey('StartCom') { [int]$StartCom } else { $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 is empty or null; skipping." | Tee-Object -FilePath $logFile -Append continue } # Build enum base/reg path $enumBase = 'HKLM:\SYSTEM\CurrentControlSet\Enum' $parts = $inst -split '\\' $sub = [string]($parts -join '\') $regPathBase = Join-Path $enumBase $sub # Candidate Device Parameters paths $candidates = @ $candidates += Join-Path $regPathBase 'Device Parameters' $candidates += Join-Path (Join-Path $regPathBase '0000') 'Device Parameters' $found = $false foreach ($dp in $candidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $found = $true "FOUND Device Parameters at: $dp" | Tee-Object -FilePath $logFile -Append # Read current properties try { $curr = Get-ItemProperty -Path $dp -ErrorAction Stop $currProps = $curr.PSObject.Properties | ForEach-Object { $_.Name } $currPort = $curr.PortName "Current PortName: $currPort" | Tee-Object -FilePath $logFile -Append } catch { "Could not read properties at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $currProps = @ $currPort = $null } # Write selective-suspend values (or WhatIf) if ($WhatIf) { "WhatIf: would set DeviceIdleEnabled/DefaultIdleState/UserSetDeviceIdleEnabled/SSIdleTimeout = 0 at $dp" | Tee-Object -FilePath $logFile -Append } else { try { New-Item -Path $dp -Force | Out-Null New-ItemProperty -Path $dp -Name 'DeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'DefaultIdleState' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'UserSetDeviceIdleEnabled' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null New-ItemProperty -Path $dp -Name 'SSIdleTimeout' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE selective-suspend values at $dp" | Tee-Object -FilePath $logFile -Append } catch { "ERROR writing selective-suspend values at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } # Disable Serial Enumerator properties foreach ($name in $explicitSerialNames) { if ($WhatIf) { "WhatIf: would set $name = 0 at $dp (explicit list)" | Tee-Object -FilePath $logFile -Append } else { try { New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE $name = 0 at $dp (explicit list)" | Tee-Object -FilePath $logFile -Append } catch { "Failed to write $name at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } $matched = @ foreach ($propName in $currProps) { if ($propName -match $serialEnumRegex) { $matched += $propName } } if ($matched.Count -gt 0) { foreach ($m in $matched) { if ($WhatIf) { "WhatIf: would set detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append } else { try { New-ItemProperty -Path $dp -Name $m -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append } catch { "Failed to write detected property $m at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } } else { "No existing properties matched serial/enum regex at $dp." | Tee-Object -FilePath $logFile -Append } # ---- COM assignment logic ---- $desiredCom = $null if ($PSBoundParameters.ContainsKey('ForceCom') -and -not [string]::IsNullOrWhiteSpace($ForceCom) { $desiredCom = $ForceCom } elseif ($PSBoundParameters.ContainsKey('StartCom') -and $null -ne $nextCom) { $desiredCom = "COM$nextCom" } else { $desiredCom = $null } if ($desiredCom) { "Desired COM for this device: $desiredCom" | Tee-Object -FilePath $logFile -Append # check current owner(s) $owners = Get-ComOwners -comName $desiredCom $inUse = ($owners -and $owners.Count -gt 0) # if current port already equals desired, skip if ($currPort -and ($currPort -eq $desiredCom) { "Device already assigned $desiredCom (no change)." | Tee-Object -FilePath $logFile -Append } elseif ($inUse -and -not $Override) { "Desired $desiredCom is already in use by another device. Skipping (use -Override to force)." | Tee-Object -FilePath $logFile -Append } else { if ($WhatIf) { "WhatIf: would set PortName = $desiredCom at $dp" | Tee-Object -FilePath $logFile -Append if ($PSBoundParameters.ContainsKey('StartCom') { $nextCom = $nextCom + 1 } } else { try { # write PortName New-ItemProperty -Path $dp -Name 'PortName' -PropertyType String -Value $desiredCom -Force -ErrorAction Stop | Out-Null "WROTE PortName = $desiredCom at $dp" | Tee-Object -FilePath $logFile -Append # optionally: record that we changed it (no attempt to update HARDWARE\DEVICEMAP\SERIALCOMM here) "Note: after changing PortName, run 'pnputil /scan-devices' or reboot to let Windows register the COM change." | Tee-Object -FilePath $logFile -Append if ($PSBoundParameters.ContainsKey('StartCom') { $nextCom = $nextCom + 1 } } catch { "Failed to set PortName at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } } else { "No COM assignment requested for this run." | Tee-Object -FilePath $logFile -Append } break # processed this device } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $found) { "Device Parameters not found under $regPathBase. Listing up to 50 child keys for diagnosis:" | Tee-Object -FilePath $logFile -Append try { Get-ChildItem -Path $regPathBase -Recurse -Depth 2 -ErrorAction Stop | Select-Object -First 50 | ForEach-Object { $_.PSPath } | Tee-Object -FilePath $logFile -Append } catch { "Could not enumerate $regPathBase : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } } } if (-not $WhatIf) { "If you applied changes, run 'pnputil /scan-devices' or reboot to have Windows pick up the new values." | Tee-Object -FilePath $logFile -Append } else { "Dry run completed (WhatIf). No registry writes performed." | Tee-Object -FilePath $logFile -Append } } catch { "Unhandled error: $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append throw
} finally { "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, run: pnputil /scan-devices (or reboot) and then check the COM port Advanced → Serial Enumerator state in Device Manager." }

<#
Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 Idempotent: only writes properties when the desired value is not already present.
Reports devices changed and those already compliant. Run as Administrator. Parameters: -WhatIf : dry run, no registry writes -StartCom : integer, starting COM number (sequential assignment) -ForceCom : string "COMn" to try to set that exact COM name for devices -Override : allow overriding an existing COM owner (dangerous) Examples: # Dry-run .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 -WhatIf # Apply and assign COMs starting at 10 .\Set-FTDI-DisableSelectiveSuspend-And-SerialEnumerator-And-ForceCOM.ps1 -StartCom 10
#> param( [switch]$WhatIf, [int]$StartCom, [string]$ForceCom, [switch]$Override) function Assert-Elevated { $isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator) if (-not $isAdmin) { Write-Error "This script must be run as Administrator. Right-click PowerShell and choose 'Run as administrator'. Exiting." exit 1 }
}
Assert-Elevated $logFile = Join-Path $env:USERPROFILE ("Desktop\FTDI_Update_{0}.log" -f (Get-Date -Format 'yyyyMMdd_HHmmss')
"Started: $(Get-Date -Format u)" | Out-File -FilePath $logFile -Encoding UTF8 # Names used to detect/create serial enumerator flags
$explicitSerialNames = @( 'SerialEnumerator','EnableSerialEnumerator','SerialEnum','SerialEnumerate','SerialEnumer','EnableSerialEnumer','SerialEnumeratorEnabled')
$serialEnumRegex = '(serial.*enum|enum.*serial|serialenumerator|enable.*serial)' # Tracking for summary
$changedDevices = @
$skippedDevices = @
$errors = @ function Get-ComOwners { param($comName) try { Get-CimInstance -ClassName Win32_SerialPort -ErrorAction SilentlyContinue | Where-Object { $_.DeviceID -eq $comName } } catch { @ }
} try { $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 by Get-PnpDevice -Class Ports." | Tee-Object -FilePath $logFile -Append throw "No FTDI COM ports found. Exiting." } "Found $($ports.Count) FTDI port(s)." | Tee-Object -FilePath $logFile -Append $nextCom = if ($PSBoundParameters.ContainsKey('StartCom') { [int]$StartCom } else { $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 continue } # Build registry base $enumBase = 'HKLM:\SYSTEM\CurrentControlSet\Enum' $parts = $inst -split '\\' $sub = [string]($parts -join '\') $regPathBase = Join-Path $enumBase $sub $candidates = @ $candidates += Join-Path $regPathBase 'Device Parameters' $candidates += Join-Path (Join-Path $regPathBase '0000') 'Device Parameters' $foundDP = $false $deviceChanged = $false foreach ($dp in $candidates) { "Checking: $dp" | Tee-Object -FilePath $logFile -Append if (Test-Path $dp) { $foundDP = $true "FOUND Device Parameters at: $dp" | Tee-Object -FilePath $logFile -Append # read current properties try { $curr = Get-ItemProperty -Path $dp -ErrorAction Stop $currProps = $curr.PSObject.Properties | ForEach-Object { $_.Name } $currPort = if ($curr.PSObject.Properties.Name -contains 'PortName') { $curr.PortName } else { $null } "Existing PortName: $currPort" | Tee-Object -FilePath $logFile -Append } catch { "Could not read $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $currProps = @ $currPort = $null } # Helper to test-and-write a DWORD property only if needed function Ensure-Dword { param($Path, $Name, $DesiredValue) $write = $false try { $existing = Get-ItemProperty -Path $Path -Name $Name -ErrorAction SilentlyContinue | Select-Object -ExpandProperty $Name -ErrorAction SilentlyContinue } catch { $existing = $null } if ($null -eq $existing) { $write = $true } elseif ([int]$existing -ne [int]$DesiredValue) { $write = $true } if ($write) { if ($WhatIf) { "WhatIf: would set $Name = $DesiredValue at $Path" | Tee-Object -FilePath $logFile -Append return $true } else { try { New-Item -Path $Path -Force | Out-Null New-ItemProperty -Path $Path -Name $Name -PropertyType DWord -Value $DesiredValue -Force -ErrorAction Stop | Out-Null "WROTE $Name = $DesiredValue at $Path" | Tee-Object -FilePath $logFile -Append return $true } catch { "ERROR writing $Name at $Path : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "ERROR writing $Name at $Path : $($_.Exception.Message)" return $false } } } else { "$Name already = $existing at $Path (no change)" | Tee-Object -FilePath $logFile -Append return $false } } # selective-suspend properties to ensure = 0 $sv1 = Ensure-Dword -Path $dp -Name 'DeviceIdleEnabled' -DesiredValue 0 $sv2 = Ensure-Dword -Path $dp -Name 'DefaultIdleState' -DesiredValue 0 $sv3 = Ensure-Dword -Path $dp -Name 'UserSetDeviceIdleEnabled' -DesiredValue 0 $sv4 = Ensure-Dword -Path $dp -Name 'SSIdleTimeout' -DesiredValue 0 if ($sv1 -or $sv2 -or $sv3 -or $sv4) { $deviceChanged = $true } # explicit serial enumerator names: only create/update if needed foreach ($name in $explicitSerialNames) { $w = $false try { $existing = Get-ItemProperty -Path $dp -Name $name -ErrorAction SilentlyContinue | Select-Object -ExpandProperty $name -ErrorAction SilentlyContinue } catch { $existing = $null } if ($null -eq $existing -or [int]$existing -ne 0) { if ($WhatIf) { "WhatIf: would set $name = 0 at $dp (explicit)" | Tee-Object -FilePath $logFile -Append $w = $true } else { try { New-ItemProperty -Path $dp -Name $name -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE $name = 0 at $dp (explicit)" | Tee-Object -FilePath $logFile -Append $w = $true } catch { "Failed to write $name at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "Failed to write $name at $dp : $($_.Exception.Message)" } } } else { "$name already = $existing at $dp (no change)" | Tee-Object -FilePath $logFile -Append } if ($w) { $deviceChanged = $true } } # regex detection among existing property names (only set existing matches) $matched = @ foreach ($propName in $currProps) { if ($propName -match $serialEnumRegex) { $matched += $propName } } if ($matched.Count -gt 0) { foreach ($m in $matched) { try { $existing = Get-ItemProperty -Path $dp -Name $m -ErrorAction SilentlyContinue | Select-Object -ExpandProperty $m -ErrorAction SilentlyContinue } catch { $existing = $null } if ($null -eq $existing -or [int]$existing -ne 0) { if ($WhatIf) { "WhatIf: would set detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append $deviceChanged = $true } else { try { New-ItemProperty -Path $dp -Name $m -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null "WROTE detected property $m = 0 at $dp (regex match)" | Tee-Object -FilePath $logFile -Append $deviceChanged = $true } catch { "Failed to write detected property $m at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "Failed to write detected property $m at $dp : $($_.Exception.Message)" } } } else { "$m already = $existing at $dp (no change)" | Tee-Object -FilePath $logFile -Append } } } else { "No existing properties matched serial/enum regex at $dp." | Tee-Object -FilePath $logFile -Append } # COM assignment logic (only write when desired COM different from current) $desiredCom = $null if ($PSBoundParameters.ContainsKey('ForceCom') -and -not [string]::IsNullOrWhiteSpace($ForceCom) { $desiredCom = $ForceCom } elseif ($PSBoundParameters.ContainsKey('StartCom') -and $null -ne $nextCom) { $desiredCom = "COM$nextCom" } if ($desiredCom) { "Desired COM: $desiredCom" | Tee-Object -FilePath $logFile -Append $owners = Get-ComOwners -comName $desiredCom $inUse = ($owners -and $owners.Count -gt 0) if ($currPort -and ($currPort -eq $desiredCom) { "Device already assigned $desiredCom (no change)." | Tee-Object -FilePath $logFile -Append } elseif ($inUse -and -not $Override) { "Desired $desiredCom is in use; skipping (use -Override to force)." | Tee-Object -FilePath $logFile -Append } else { if ($WhatIf) { "WhatIf: would set PortName = $desiredCom at $dp" | Tee-Object -FilePath $logFile -Append $deviceChanged = $true if ($PSBoundParameters.ContainsKey('StartCom') { $nextCom = $nextCom + 1 } } else { try { New-ItemProperty -Path $dp -Name 'PortName' -PropertyType String -Value $desiredCom -Force -ErrorAction Stop | Out-Null "WROTE PortName = $desiredCom at $dp" | Tee-Object -FilePath $logFile -Append $deviceChanged = $true if ($PSBoundParameters.ContainsKey('StartCom') { $nextCom = $nextCom + 1 } } catch { "Failed to set PortName at $dp : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append $errors += "Failed to set PortName at $dp : $($_.Exception.Message)" } } } } else { "No COM assignment requested for this device." | Tee-Object -FilePath $logFile -Append } if ($deviceChanged) { $changedDevices += $inst } else { $skippedDevices += $inst } break } else { "Not found: $dp" | Tee-Object -FilePath $logFile -Append } } if (-not $foundDP) { "Device Parameters not found under $regPathBase. Listing children for diagnosis:" | Tee-Object -FilePath $logFile -Append try { Get-ChildItem -Path $regPathBase -Recurse -Depth 2 -ErrorAction Stop | Select-Object -First 50 | ForEach-Object { $_.PSPath } | Tee-Object -FilePath $logFile -Append } catch { "Could not enumerate $regPathBase : $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append } $skippedDevices += $inst } } # Summary "=== Summary ===" | Tee-Object -FilePath $logFile -Append if ($changedDevices.Count -gt 0) { "Devices changed: $($changedDevices.Count)" | Tee-Object -FilePath $logFile -Append $changedDevices | Tee-Object -FilePath $logFile -Append } else { "No devices required updates." | Tee-Object -FilePath $logFile -Append } if ($skippedDevices.Count -gt 0) { "Devices already compliant / skipped: $($skippedDevices.Count)" | Tee-Object -FilePath $logFile -Append $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 } if (-not $WhatIf) { "If you changed PortName values, run 'pnputil /scan-devices' or reboot so Windows re-registers COM assignments." | Tee-Object -FilePath $logFile -Append } else { "Dry run (WhatIf). No registry writes performed." | Tee-Object -FilePath $logFile -Append } } catch { "Unhandled error: $($_.Exception.Message)" | Tee-Object -FilePath $logFile -Append throw
} finally { "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, run: pnputil /scan-devices (or reboot) and then verify COMs and Advanced -> Serial Enumerator in Device Manager." }

<#
Disable-FTDI-SelectiveSuspend-ApplyIfMissing.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. 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: 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 } } } 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"