---
title: Add federated domain
description: On the Windows machine with the account connection software, run the Windows Azure Active Directory Module for Windows Powershell application.
component: office365
page_id: office365:office_365_provisioner:pf_office365_connector_add_federated_domain
canonical_url: https://docs.pingidentity.com/integrations/office365/office_365_provisioner/pf_office365_connector_add_federated_domain.html
revdate: July 3, 2024
section_ids:
  steps: Steps
---

# Add federated domain

## Steps

1. On the Windows machine with the account connection software, run the **Windows Azure Active Directory Module for Windows Powershell** application.

   |   |                                                                                                                                                                                                                                             |
   | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | Any instructions beginning with "PS>" indicate that the command to the right of the mentioned text is to be executed at the Powershell command line in the **Windows Azure Active Directory Module for Windows Powershell** command prompt. |

2. Connect to Azure Active Directory:

   ```
   PS> Connect-MsolService
   ```

3. Enter the username and password for the Azure account with administrative privileges.

   |   |                                                                                                                                                                                                                                                                                                                      |
   | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | Text surrounded by "<" and ">" is intended to be replaced with a substitution indicated by the text between the symbols. For example, if the name of your federated domain is `myfederateddomain.com`, then `<federated_domain_name>` should be replaced by `myfederateddomain.com` before execution of the command. |

4. Add the federated domain:

   ```
   PS> New-MsolDomain -name "<federated_domain_name>" -Authentication Federated
   ```

5. Get the domain label prefix value to aid in domain verification:

   ```
   PS> Get-MsolDomainVerificationDns -DomainName "<federated_domain_name>"
   ```

   Note the prefix of the value in the Label field and save for later use. (for example, the prefix will be in the format `ms##`)

   ![amf1563995521709](_images/amf1563995521709.jpg)

   |   |                                                                                                                                                                                                                                         |
   | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | To preserve some of the setup completed in the previous steps, leave the **Windows Azure Active Directory Module for Windows Powershell**command prompt window open until configuration of the Office 365 Connector has been completed. |