Logging

powerAPS uses Apache log4net as core logging library, and additionally PostSharp Diagnostics for extended Debug logging.

All log messages - Info, Warning, Error, and optionally Debug - from powerAPS Cmdlets are written to the PowerShell console as well as to the coolOrange powerGate log file.
The log file is located at ‘C:\Users\{USER}\AppData\Local\coolOrange\powerGate\Logs\powerGate.log’. It is available on both Job Processor and workstation environments, with a powerGate Logs shortcut in the Start menu for quick access.

Log file location and behavior are fully controlled by the powerGate.log4net configuration. For details, refer to:

coolOrange powerGate Logging Guide

Customizing Logging for APS Cmdlets

To adjust the logging behavior specifically for powerAPS Cmdlets, add a dedicated logger section to your powerGate.log4net configuration file.
For example:

  ...
</root>

<!-- Enable extended logging for APS Cmdlets -->
<logger name="powerAPS.Cmdlets">
	<level value="DEBUG" />
</logger>

Place this logger section below the root logger entry. This allows you to control the log level, for example enabling DEBUG logging for more detailed output during troubleshooting, and to define where logs are written for auditing purposes.