Skip to content

Update how-to-connect-install-multiple-domains.md #1693

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

Macorder-hub
Copy link

Changes needed to take effect soon due to the number of customers using this public documentation.

Changes needed to take effect soon due to the number of customers using this public documentation.
Copy link
Contributor

Learn Build status updates of commit 15debbd:

✅ Validation status: passed

File Status Preview URL Details
docs/identity/hybrid/connect/how-to-connect-install-multiple-domains.md ✅Succeeded

For more details, please refer to the build report.

@Court72
Copy link
Contributor

Court72 commented Jul 29, 2025

@Macorder-hub,

Thank you for your contribution. Would you take a moment to sign the Contributor License Agreement (CLA)? After the CLA is signed, someone can review your pull request.

It looks like you can access the private repo, so you might consider opening this pull request there instead. Thanks!

@Court72
Copy link
Contributor

Court72 commented Jul 29, 2025

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@Macorder-hub
Copy link
Author

@microsoft-github-policy-service agree company="Microsoft"

Copy link
Contributor

@Macorder-hub : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@Court72
Copy link
Contributor

Court72 commented Jul 29, 2025

@omondiatieno

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

@Macorder-hub Macorder-hub marked this pull request as ready for review August 18, 2025 19:34
@Macorder-hub
Copy link
Author

@omondiatieno @Court72 hello. Any update regarding this content update?

Copy link
Contributor

@omondiatieno omondiatieno left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Macorder-hub, thanks for contributing to this PR. I'll help you add the image to the private repo first, then we can link to it and merge the PR. I also added some minor suggestions


Use the steps below to add an additional top-level domain. If you have already added a domain, and didn't use the `-SupportMultipleDomain` parameter, start with the steps for removing and updating your original domain. If you haven't added a top-level domain yet, you can start with the steps for adding a domain using PowerShell of Microsoft Entra Connect.
1. Open a new PowerShell session and run the below commands to install the Entra module:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Open a new PowerShell session and run the below commands to install the Entra module:
1. Open a new PowerShell session and run the below commands to install the Microsoft Entra PowerShell module:


Use the following steps to remove the Microsoft Online trust and update your original domain.
<img width="1774" height="165" alt="Get-EntraFedProperty" src="https://github.com/user-attachments/assets/4c74f81a-a438-4ad1-a6a2-9ccc365288bc" />
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll need to add this image through the private repo.


Use the following steps to add the new top-level domain using PowerShell

1. On a machine that has [Azure AD PowerShell module](/previous-versions/azure/jj151815(v=azure.100)) installed on it run the following PowerShell: `$cred=Get-Credential`.
2. Enter the username and password of a Hybrid Identity Administrator for the Microsoft Entra domain you're federating with
3. In PowerShell, enter `Connect-Entra -Scopes 'Domain.ReadWrite.All'`
4. In PowerShell, enter `New-MgDomainFederationConfiguration –SupportMultipleDomain –DomainName`
4. Enter all the values as the below example to add a new domain:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. Enter all the values as the below example to add a new domain:
4. Enter all the values to add a new domain as shown in the following example:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants