Skip to content

Events

Pode lets you register scripts to be run when certain server events are triggered. The following types of events can have scripts registered:

  • Start
  • Terminate
  • Restart
  • Browser
  • Crash
  • Stop

Overview

You can use Register-PodeEvent to register a script that can be run when an event within Pode is triggered. Each event can have multiple scripts registered, and you can unregister a script at any point using Unregister-PodeEvent:

# register:
Register-PodeEvent -Type Start -Name '<name>' -ScriptBlock {
    # inform a portal, write a log, etc
}

# unregister:
Unregister-PodeEvent -Type Start -Name '<name>'

The scriptblock supplied to Register-PodeEvent also supports $using: variables. You can retrieve a registered script using Get-PodeEvent:

$evt = Get-PodeEvent -Type Start -Name '<name>'

Types

Start

Scripts registered to the Start event will all be invoked just after the server's main scriptblock has been invoked - ie: the -ScriptBlock supplied to Start-PodeServer.

These scripts will also be re-invoked after a server restart has occurred.

Terminate

Scripts registered to the Terminate event will all be invoked just before the server terminates. Ie, when the Terminating... message usually appears in the terminal, the script will run just after this and just before the Done message.

These script will not run when a Restart is triggered.

Restart

Scripts registered to the Restart event will all be invoked whenever an internal server restart occurs. This could be due to file monitoring, auto-restarting, Ctrl+R, or Restart-PodeServer. They will be invoked just after the Restarting... message appears in the terminal, and just before the Done message.

Browser

Scripts registered to the Browser event will all be invoked whenever the server is told to open a browser, ie: when Ctrl+B is pressed.

Crash

Scripts registered to the Crash event will all be invoked if the server ever terminates due to an exception being thrown. If a Crash event it triggered, then Terminate will not be triggered.

Stop

Scripts registered to the Stop event will all be invoked when the server stops and closes. This event will be fired after either the Terminate or Crash events - which ever one causes the server to ultimately stop.