This guide outlines the process for using AVOXI-provided PowerShell scripts to pre-configure and add the necessary domain records for your Microsoft 365 tenant. This initial step is required before you can fully verify your domains within the Microsoft 365 admin center.

Based on the instructions provided in the video, here is a knowledge base article detailing how to add and prepare domains for Microsoft 365 verification using PowerShell scripts provided by AVOXI.

Prerequisites

Before starting, ensure you have the following:

A list of FQDNs (Fully Qualified Domain Names) provided by AVOXI, typically one for each data center relevant to your AVOXI installation.

For example, customer account number = 12345

The AVOXI PowerShell scripts, including:

PowerShell installed on your system.

A Global Administrator account for your Microsoft 365 tenant to log in during the script execution.

A setup script (e.g., Local-PowerShell-Setup.ps1). This will check if all the needed modules are installed and will connect with your tenant utilizing the Global administrator account.

A domain creation script (e.g., Domain-Creation.ps1).

1. Prepare and Connect to Microsoft 365/Teams

This step runs the initial setup script, which checks for required PowerShell modules and establishes a connection to your Microsoft 365 tenant.

Step 1: Open PowerShell and Run the Setup Script

Open PowerShell on your computer.

Navigate to the directory where you saved the AVOXI scripts.

Execute the setup script by drag and drop or type the path into your Powershell terminal and pressing Enter (e.g., ./Users/cirss.soto/Desktop/AVOXI/1-47607-Local-PowerShell-Setup.ps1).

Step 2: Install Required Modules (Automatic)

The script will first perform a check for the required modules: Microsoft.Graph and Microsoft.Teams.

If the modules are not installed, the script will install them automatically.

If they are already installed, the script will simply confirm their presence.

Step 3: Log in to Microsoft 365/Teams

After checking the modules, the script will prompt you to connect to Microsoft 365 and Microsoft Teams.

A Microsoft sign-in window will appear. Log in using your Global Administrator account for the Microsoft 365 tenant.

Note: Upon successful connection, the PowerShell window will display a "Connected to Microsoft 365 and Teams" message, including a "Module Summary" and your tenant information.

2. Add and Process Domain Installation Records

This step uses the domain creation script to add the necessary domain installation records (MS messages) for all your FQDNs into the tenant.

Step 1: Run the Domain Creation Script

Drag and drop or type the path to the Domain Creation Script into the active PowerShell window (e.g., ./Users/cirss.soto/Desktop/AVOXI/2-47607-Domain-Creation.ps1).

Press Enter to run the script.

Step 2: Observe Domain Processing

The script will begin processing each domain provided in your list.

For each domain, the script will report:

The domain name being processed.

A confirmation that the domain was added successfully.

The corresponding TXT Record value with its unique MS= verification text (e.g., MS=71580666).

Step 3: Copy and Send Verification Information to AVOXI

Once the script finishes, a table titled "Microsoft 365 Domain Verification Records" will appear, listing all domains, their verification TXT records, and the status "Added Successfully."

Select and copy this entire table/list of domain names and their MS= TXT records.

Reply to the original AVOXI support case email and provide this copied information. This data is essential for AVOXI to correctly configure the FQDNs and verify the domains later.

Important: The domain creation is now complete in the tenant, but they are not yet fully verified or set up

3. Verify Domain Status in Microsoft 365 Admin Center

After running the script, you can check the status of the added domains in the Microsoft 365 admin center.

Step 1: Navigate to the Domains Page

Log into the Microsoft 365 admin center (https://www.google.com/search?q=admin.microsoft.com).

In the left-hand navigation pane, click "Show all" to expand the menu.

Under "Settings," click on “Domains.”

Step 2: Review Domain Status

You will see the list of domains added by the PowerShell script (typically with a number prefix like 12345-msteams-a-us1.ucaas.avoxi.net).

The Status column for these new domains will display "Incomplete setup." This is the expected state until AVOXI completes their verification step on their side.

Next Steps

The next stage, "How to Install and Verify Domains," will be completed once AVOXI confirms the successful TXT record update and verification, allowing you to use a final script or the admin center interface to finalize the domain setup.