Skip to content

Instantly share code, notes, and snippets.

@CMCDragonkai

CMCDragonkai/stay-awake.ps1

Last active October 24, 2025 18:20
Show Gist options
  • Save CMCDragonkai/bf8e8b7553c48e4f65124bc6f41769eb to your computer and use it in GitHub Desktop.
Save CMCDragonkai/bf8e8b7553c48e4f65124bc6f41769eb to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. CMCDragonkai revised this gist Jan 17, 2017. No changes.
  2. CMCDragonkai revised this gist Jan 17, 2017. 1 changed file with 4 additions and 0 deletions.
    4 changes: 4 additions & 0 deletions stay-awake.ps1
    View file
    Original file line number Diff line number Diff line change
    @@ -8,6 +8,10 @@
    # System Mode - Don't go to sleep or hibernation
    # The default mode is the System Mode.
    # Away mode is only available when away mode is enabled in the advanced power options.
    # These commands are advisory, the option to allow programs to request to disable
    # sleep or display off is in advanced power options.
    # The above options will need to be first enabled in the registry before you can
    # see them in the advanced power options.
    # An alternative to this script is using presentation mode, but this is more flexible.

    param (
  3. CMCDragonkai created this gist Jan 17, 2017.
    57 changes: 57 additions & 0 deletions stay-awake.ps1
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,57 @@
    #!/usr/bin/env powershell

    # This script can keep the computer awake while executing another executable, or
    # if no executable was passed in, then it stays awake until this script stops.
    # There are 3 different ways of staying awake:
    # Away Mode - Enable away mode (https://blogs.msdn.microsoft.com/david_fleischman/2005/10/21/what-does-away-mode-do-anyway/)
    # Display Mode - Keep the display on and don't go to sleep or hibernation
    # System Mode - Don't go to sleep or hibernation
    # The default mode is the System Mode.
    # Away mode is only available when away mode is enabled in the advanced power options.
    # An alternative to this script is using presentation mode, but this is more flexible.

    param (
    [string]$Executable = $null,
    [ValidateSet('Away', 'Display', 'System')]$Option = 'System'
    )

    $Code=@'
    [DllImport("kernel32.dll", CharSet = CharSet.Auto,SetLastError = true)]
    public static extern void SetThreadExecutionState(uint esFlags);
    '@

    $ste = Add-Type -memberDefinition $Code -name System -namespace Win32 -passThru

    # Requests that the other EXECUTION_STATE flags set remain in effect until
    # SetThreadExecutionState is called again with the ES_CONTINUOUS flag set and
    # one of the other EXECUTION_STATE flags cleared.
    $ES_CONTINUOUS = [uint32]"0x80000000"
    $ES_AWAYMODE_REQUIRED = [uint32]"0x00000040"
    $ES_DISPLAY_REQUIRED = [uint32]"0x00000002"
    $ES_SYSTEM_REQUIRED = [uint32]"0x00000001"

    Switch ($Option) {
    "Away" {$Setting = $ES_AWAYMODE_REQUIRED}
    "Display" {$Setting = $ES_DISPLAY_REQUIRED}
    "System" {$Setting = $ES_SYSTEM_REQUIRED}
    }

    try {

    Write-Host "Staying Awake with ``${Option}`` Option"

    $ste::SetThreadExecutionState($ES_CONTINUOUS -bor $Setting)

    if ($Executable) {
    Write-Host "Executing Executable"
    & "$Executable"
    } else {
    Read-Host "Enter or Exit to Stop Staying Awake"
    }

    } finally {

    Write-Host "Stopping Staying Awake"
    $ste::SetThreadExecutionState($ES_CONTINUOUS)

    }