SophosFirewall.Diagnostics

1.4.1

PowerShell module for the MONITOR & ANALYZE > Diagnostics area of Sophos XGS / SFOS 22.0 firewalls: remote support access, read-only access to the web admin console log viewer and dashboard (service status, firewall health check, system usage graphs), and running commands on the appliance device console. Intended for administrators who need to open a temporary support
PowerShell module for the MONITOR & ANALYZE > Diagnostics area of Sophos XGS / SFOS 22.0 firewalls: remote support access, read-only access to the web admin console log viewer and dashboard (service status, firewall health check, system usage graphs), and running commands on the appliance device console. Intended for administrators who need to open a temporary support channel, review recent log or system activity, or reach the device console without a physical or serial connection.
Show more

Minimum PowerShell version

5.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name SophosFirewall.Diagnostics

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name SophosFirewall.Diagnostics

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Package Details

Author(s)

  • Jan Weis

Tags

Sophos Firewall API XGS SFOS Diagnostics SupportAccess LogViewer

Functions

Enter-SfosCliConsole Export-SfosLog Get-SfosControlCenter Get-SfosHealthCheck Get-SfosHealthCheckSummary Get-SfosLog Get-SfosLogCategory Get-SfosServiceStatus Get-SfosSupportAccess Get-SfosSystemGraph Import-SfosLog Invoke-SfosCliConsoleCommand Set-SfosHealthCheckOverride Set-SfosSupportAccess

PSEditions

Desktop Core

Dependencies

Release Notes

1.4.1: Reads the health assessment and the control center figures that the XML API does not expose. Get-SfosHealthCheck lists the compliance checks of the firewall with severity, standard and status; Get-SfosHealthCheckSummary aggregates them, and Set-SfosHealthCheckOverride marks a single check as accepted, which also hides a real deficit from the summary. Get-SfosServiceStatus lists every system service with its state, or the overall verdict with -Overall. Get-SfosSystemGraph returns the CPU, memory, load average, connection and throughput series of the control center for four time ranges, including current, minimum, maximum and average per series. Get-SfosControlCenter answers the whole dashboard in a single request: uptime, processor cores, live and remote users, wireless access points, Security Heartbeat, firewall rule counts, traffic counters and RED status. Fixed: Enter-SfosCliConsole could wait indefinitely with no output and no error when run in a host that has no real keyboard input, such as redirected input or a non-interactive script call; it now checks for that before opening a session and fails immediately with a clear message. New -DeviceConsole switch on Enter-SfosCliConsole selects the device console automatically after connecting, so the session starts at the console prompt instead of at the main menu.

FileList

Version History

Version Downloads Last updated
1.4.1 (current version) 8 8/27/2026
1.4.0 13 8/22/2026