Mastering Windows PowerShell Scripting - Third Edition

The OnRemove event

The ModuleInfo object provides access to an OnRemove event handler. This event is triggered if the module is removed from the user's session using the Remove-Module command. The event is not triggered if the session is closed. This event handler may be used to trigger a cleanup of the artifacts created by the module, if any are required.

The following module creates a global variable in the user's scope. Exporting the variable from the module using VariablesToExport and Export-ModuleMember may have been a better approach, the variable would have been automatically removed. An OnRemove handler is added to the module to forcefully remove the global variable with the module and the handler is created in the root module file: ...