PowerPlanTools is a PowerShell Binary Module for native management of Windows Power Plans and Power Settings. It provides a comprehensive set of cmdlets for managing power plans without relying on powercfg.exe.

• Native power plan and setting manipulation using Windows Power Management API (no powercfg.exe)
• Full alias support for all known power setting GUIDs
• Comprehensive subgroup alias mapping for better organization
• Automatic inclusion of possible values for power settings
• Optional raw GUID input for advanced use
• Tab-completion for PlanName, SettingAlias, SubGroupAlias, and SettingGuid
• Export/Import of power plans using native API (JSON, CSV, or XML formats)
• Advanced search capabilities with regex and wildcard pattern support
• Power plan statistics over time using event logs
• Full metadata output (-WithMetadata)
• Support for hidden settings (-IncludeHidden)
• Pipeline support for all relevant cmdlets
• Full support for -WhatIf, -Confirm, -Force
• Detailed verbose logging with timestamps and progress counters

# Install the module from PowerShell Gallery
Install-Module -Name PowerPlanTools -Scope CurrentUser

1. Download the latest release ZIP file from the Releases page
2. Extract the ZIP file to a temporary location
3. Run the included Install-PowerPlanTools.ps1 script, which will:
   • Find the appropriate PowerShell modules directory
   • Create a PowerPlanTools folder if it doesn't exist
   • Copy all module files to the correct location

1. Download the latest release ZIP file from the Releases page
2. Extract the ZIP file to a temporary location
3. Copy the PowerPlanTools folder to one of these locations:
   • $env:USERPROFILE\Documents\WindowsPowerShell\Modules\ (for current user)
   • $env:ProgramFiles\WindowsPowerShell\Modules\ (for all users, requires admin)

# Clone the repository
git clone https://github.com/Grace-Solutions/PowerPlanTools.git
cd PowerPlanTools

# Copy the module to your PowerShell modules directory
$modulePath = "$env:USERPROFILE\Documents\WindowsPowerShell\Modules"
Copy-Item -Path ".\Module\PowerPlanTools" -Destination $modulePath -Recurse -Force

# Clone the repository
git clone https://github.com/Grace-Solutions/PowerPlanTools.git
cd PowerPlanTools

# Build the module
.\build.ps1

# Install the module
.\Releases\<version>\Install-PowerPlanTools.ps1

# Import the module
Import-Module PowerPlanTools

# List all available power plans
Get-PowerPlan

# Get details about the current power plan
Get-PowerPlan -Active

# Get a power plan with all its settings (settings are always included)
Get-PowerPlan -Name "Balanced"

# Find power settings related to display
Find-PowerSetting -SearchString "display"

# Find power settings using regex pattern
Find-PowerSetting -SearchString "^processor.*state$" -Regex

# Find power settings using wildcard pattern
Find-PowerSetting -SearchString "USB*suspend*" -Wildcard

# Find power settings in a specific subgroup
Find-SubGroup -Name "*processor*"
Find-PowerSetting -SearchString "processor" | Where-Object { $_.SubGroupAlias -eq "Processor Power Management" }

# Export a power plan to JSON
Export-PowerSettings -Name "Balanced" -Path "C:\Temp\BalancedPlan.json"

# Import power settings from a file
Import-PowerSettings -Path "C:\Temp\BalancedPlan.json" -Name "Custom Plan" -CreateIfNotExists

# Get power state settings
Get-PowerState

# Set power state settings
Set-PowerState -EnableHibernate $true

• Get-PowerPlan - Lists all power plans or gets a specific plan
• New-PowerPlan - Creates a new power plan
• Remove-PowerPlan - Deletes a power plan
• Set-PowerPlan - Sets the active power plan
• Reset-PowerPlanDefaults - Resets a power plan to default settings

• Get-PowerSetting - Gets power settings for a plan
• Update-PowerSetting - Updates a power setting value
• Find-PowerSetting - Searches for power settings by name, description, or GUID
• Find-SubGroup - Searches for power setting subgroups by name or GUID
• Export-PowerSettings - Exports power settings to a file (JSON, CSV, XML)
• Import-PowerSettings - Imports power settings from a file

• Compare-PowerPlans - Compares settings between power plans
• Get-PowerPlanStatistic - Gets power plan usage statistics

• Get-PowerState - Gets the current power state settings
• Set-PowerState - Configures power state settings like hibernation, connected standby, etc.

• CHANGELOG.md - Version history and changes
• INSTALL.md - Detailed installation instructions
• USAGE.md - Detailed usage instructions and examples
• API-SPEC.md - API specification
• MODULE-STRUCTURE.md - Module structure documentation

This project is licensed under the MIT License - see the LICENSE file for details.