Event Viewer
You can log items to the Windows Event Viewer, using Pode's unbuilt Event Viewer logging logic. You can log anything, but it's best to use this in conjunction with Enable-PodeErrorLogging
and Write-PodeErrorLog
.
Errors will be logged using an appropriate error level, but other log items will be logged as Informational by default.
By default, Pode will log to the Application log with a source of Pode, and an Event ID of 0.
Usage
When using this log method, Pode will first check if the source exists, and will then attempt to create it. To do this, you will need to be running Pode as an administrator.
If however you're running Pode locally, or in a situation where you can't run Pode as a full admin - like in IIS - then you will first have to create the source yourself manually. Assuming a source of Pode
and in the Application
log, you can use the following:
[System.Diagnostics.EventLog]::CreateEventSource('Pode', 'Application')
Once the source is created, Pode can log to the Event Viewer without being an admin!
To enable and log errors to the Event Viewer, the following will work:
New-PodeLoggingMethod -EventViewer | Enable-PodeErrorLogging
This will log to the Application
log using Pode
as the source.
Event Log
To log to a different event log, other than Application, you can specify the log via -EventLogName
:
New-PodeLoggingMethod -EventViewer -EventLogName SomeLogName | Enable-PodeErrorLogging
Event Source
To log using a different source, other than Pode, you can specify the source via -Source
:
New-PodeLoggingMethod -EventViewer -Source WebsiteName | Enable-PodeErrorLogging