Sign in
Customer Portal

Symbol Allowlisting Scripts (Microsoft)

This article explains how to download and run the Symbol Allowlisting scripts using PowerShell on your Windows or macOS devices.

If you want to automate allowlisting Symbol IPs and domains in your email environment, the Symbol Allowlisting Script is the fastest, most reliable option. It opens a secure Microsoft sign-in window, applies all required allowlisting settings for Symbol (including domains and IPs), does not send any emails, does not modify user accounts, and typically completes the allowlisting process in about 1–2 minutes.

‼️ Important: Existing settings will be overwritten This script overrides registered Domains/IPs in your Microsoft 365 tenant. Ensure you have a backup of your current settings or use the included optional export script to save them before continuing.

What’s Included in the Download?

When downloading the PowerShell scripts from the Symbol app, you’ll get a .zip file containing 2 different files:

  • symbol_sma.ps1 - (Powershell Script).

  • symbol_sma_export.ps1 (Optional script to export existing IPs/Domains).

Here’s how to run it on Windows and macOS:

Windows (Microsoft)

**STEP 1: ENSURE POWERSHELL IS INSTALLED
** Most Windows computers already have PowerShell installed. If PowerShell is not installed on your device, then follow these steps to get PowerShell:

  • Open your preferred web browser

  • Go to: https://aka.ms/powershell

  • Click on “Download (Setup & Installation)”

  • Choose the “Install PowerShell o Windows” option (Ensure you get PowerShell v7).

  • You can also install it by using this command:

    • winget install –id Microsoft.PowerShell –source winget

  • Restart your computer (if prompted).

STEP 2: DOWNLOAD THE SYMBOL ALLOWLISTING SCRIPT
  • Go to https://app.symbolsecurity.com
  • Navigate to the settings page of the company where you want to do the whitelist.
  • Locate the section saying “Symbol Allowlisting Script (PowerShell) “.
  • Click on “Download " to get the Symbol Allowlisting script.

STEP 3: EXECUTE THE SCRIPT

  • Open PowerShell:

  • Navigate to the folder where you have Symbol script, e.g:

    • $ cd $HOME\Downloads

  • Give permissions by running this command:

    • Install-Module ExchangeOnlineManagement -Repository PSGallery -Force

  • Run the script directly with the following command:

    • .\symbol-sma.ps1

  • Sign in to your account when the Microsoft prompt appears.

  • ‼️Important: Confirm you want to override existing Domains/IPs in your Microsoft 365 tenant.

  • Wait until the script finishes running.

macOS (Apple)

**STEP 1: ENSURE POWERSHELL IS INSTALLED
** To check if PowerShell is installed on your Mac, open your Terminal application and try to launch it using the standard command pwsh. If it doesn’t work, follow these steps to get PowerShell:

  • Open your preferred web browser

  • Go to: https://aka.ms/powershell

  • Click on “Download (Setup & Installation)”

  • Choose the “Install on macOS” option (Ensure you get PowerShell v7).

  • Restart your computer (if prompted).

  • You can also install it using brew , by running the command:

    • brew install –cask powershell
STEP 2: DOWNLOAD THE SYMBOL ALLOWLISTING SCRIPT
  • Go to https://app.symbolsecurity.com
  • Navigate to the settings page of the company where you want to do the whitelist.
  • Locate the section saying “Symbol Allowlisting Script (PowerShell) “.
  • Click on “Download " to get the Symbol Allowlisting script.
STEP 3: EXECUTE THE SCRIPT

  • Open the Terminal

  • Navigate to the folder where the Symbol script is located, e.g:

    • cd ~/Downloads

  • Run the script directly with the following command:

    • ./symbol-sma.ps1

  • If you get a “Permissions Denied” error, run this command instead:

    • chmod +x ~/Downloads/symbol-sma.ps1

  • Sign in to your account when the Microsoft prompt appears.

  • Wait for the script to complete

Troubleshooting Tips

  • The first time you run a downloaded script, macOS may block execution, ensure you run:

    • chmod +x ~/folder_name/symbol-sma.ps1

  • To verify PowerShell version on Windows, run:** **

    • winget search –id Microsoft.PowerShell

  • To verify PowerShell version on macOS, run:

    • pwsh –version

  • Make sure you are signed in with a Microsoft account that has admin permissions.

  • Confirm the script file name is correct.

  • Restart Terminal or PowerShell if authentication does not launch.

**
NEED HELP?**

If the script fails or you encounter issues, contact Symbol Support and include:

  • Your operating system (Windows or macOS).

  • Any error messages shown.

  • Confirmation that PowerShell is installed.

Back to Whitelisting