Fix Exchange Online PowerShell TLS Errors on macOS
Question details
The user is encountering TLS certificate verification errors when attempting to connect to Exchange Online PowerShell from a macOS environment.

- Product
- Exchange Online PowerShell
- Device & OS
- macOS
- Scenario
- Connecting to Exchange Online PowerShell to manage Microsoft Exchange services remotely using a Mac
- Observed behavior
- The connection fails with a TLS certificate verification error, often displaying as a tls_process_server_certificate error, preventing the session from establishing.
Ensure you have administrator privileges on your macOS device and a stable internet connection before modifying system certificates or upgrading PowerShell packages.
Update macOS, PowerShell, and the Exchange Module
Outdated system components or PowerShell versions often lack support for Microsoft's latest TLS security protocols. Updating everything ensures full compatibility.
Microsoft frequently updates its security requirements for Exchange Online. If your PowerShell core installation or the Exchange Online Management module is outdated, macOS may fail to verify the TLS certificates.
Open 'System Settings' (or System Preferences) on your Mac, navigate to 'General', and click 'Software Update' to ensure your operating system has the latest root certificates installed.
Open the Terminal app. If you installed PowerShell via Homebrew, type 'brew upgrade --cask powershell' and press Enter to install the latest stable version.
Launch PowerShell by typing 'pwsh' in your Terminal. Run the command 'Update-Module -Name ExchangeOnlineManagement' to ensure you have the latest V2 or V3 module.
Restart your PowerShell session and try running 'Connect-ExchangeOnline' again to verify if the TLS error is resolved.

Manually Force TLS 1.2 in PowerShell
If your environment defaults to an older TLS protocol, you can manually force PowerShell to use TLS 1.2 before initiating the connection.
Enhance Your macOS Productivity with WPS Office
While you troubleshoot administrative PowerShell connections for Exchange, you might also need a robust software solution for your daily document workflows. WPS Office is a completely free, lightweight, and powerful alternative to Microsoft Office designed to work flawlessly on macOS.
- 1. Download for Mac: Visit the WPS Office website and download the official macOS installer.
- 2. Install the Software: Open the downloaded .dmg file and drag the WPS Office icon to your Applications folder.
- 3. Open and Edit Files: Launch WPS Office and instantly open your existing Microsoft Office files without losing any formatting.

Frequently Asked Questions
Why am I seeing the tls_process_server_certificate error exclusively on my Mac?
This error generally occurs because the local OpenSSL implementation utilized by PowerShell on macOS fails to verify the SSL/TLS certificate from the Exchange server. This is often caused by outdated macOS root certificates or an outdated PowerShell Core installation.
Does the Exchange Online PowerShell module fully support macOS?
Yes. The Exchange Online PowerShell V2 (and V3) modules natively support macOS, provided you are running PowerShell Core version 7 or higher. Older Windows PowerShell environments do not apply to Mac.
What should I do if updating components doesn't fix the TLS error?
If updating macOS, PowerShell, and the module doesn't resolve the issue, you can try temporarily disabling certificate revocation checks, or compile the full error logs and share them with the Microsoft Tech Community or PowerShell community forums for deeper investigation.




