Skip to content

Commit 3563eab

Browse files
committed
adding Frank's changes
1 parent cc40182 commit 3563eab

File tree

1 file changed

+23
-9
lines changed

1 file changed

+23
-9
lines changed

articles/active-directory/enterprise-users/domains-manage.md

Lines changed: 23 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.service: active-directory
1010
ms.subservice: enterprise-users
1111
ms.workload: identity
1212
ms.topic: how-to
13-
ms.date: 06/23/2022
13+
ms.date: 11/11/2022
1414
ms.author: barclayn
1515
ms.reviewer: sumitp
1616

@@ -20,7 +20,7 @@ ms.collection: M365-identity-device-management
2020
---
2121
# Managing custom domain names in your Azure Active Directory
2222

23-
A domain name is an important part of the identifier for resources in many Azure Active Directory (Azure AD), part of Microsoft Entra: it's part of a user name or email address for a user, part of the address for a group, and is sometimes part of the app ID URI for an application. A resource in Azure AD can include a domain name that's owned by the Azure AD organization (sometimes called a tenant) that contains the resource. Only a Global Administrator can manage domains in Azure AD.
23+
A domain name is an important part of the identifier for resources in many Azure Active Directory (Azure AD) deployments. It is part of a user name or email address for a user, part of the address for a group, and is sometimes part of the app ID URI for an application. A resource in Azure AD can include a domain name that's owned by the Azure AD organization (sometimes called a tenant) that contains the resource. Only a Global Administrator can manage domains in Azure AD.
2424

2525
## Set the primary domain name for your Azure AD organization
2626

@@ -50,7 +50,7 @@ If you have already added a contoso.com domain to one Azure AD organization, you
5050

5151
## What to do if you change the DNS registrar for your custom domain name
5252

53-
If you change the DNS registrars, there are no additional configuration tasks in Azure AD. You can continue using the domain name with Azure AD without interruption. If you use your custom domain name with Microsoft 365, Intune, or other services that rely on custom domain names in Azure AD, see the documentation for those services.
53+
If you change the DNS registrars, there are no other configuration tasks in Azure AD. You can continue using the domain name with Azure AD without interruption. If you use your custom domain name with Microsoft 365, Intune, or other services that rely on custom domain names in Azure AD, see the documentation for those services.
5454

5555
## Delete a custom domain name
5656

@@ -67,7 +67,7 @@ You must change or delete any such resource in your Azure AD organization before
6767
> [!Note]
6868
> To delete the custom domain, use a Global Administrator account that is based on either the default domain (onmicrosoft.com) or a different custom domain (mydomainname.com).
6969
70-
### ForceDelete option
70+
## ForceDelete option
7171

7272
You can **ForceDelete** a domain name in the [Azure AD Admin Center](https://aad.portal.azure.com) or using [Microsoft Graph API](/graph/api/domain-forcedelete). These options use an asynchronous operation and update all references from the custom domain name like “[email protected]” to the initial default domain name such as “[email protected].”
7373

@@ -87,22 +87,36 @@ An error is returned when:
8787
* The number of objects to be renamed is greater than 1000
8888
* One of the applications to be renamed is a multi-tenant app
8989

90-
### Frequently asked questions
90+
## Best Practices for Domain Hygiene
91+
92+
Use a reputable registrar that provides ample notifications for domain name changes, registration expiry, a grace period for expired domains, and maintains high security standards for controlling who has access to your domain name configuration and TXT records.
93+
Keep your domain names current with your Registrar, and verify TXT records for accuracy.
94+
95+
* If you purposefully are expiring your domain name or turning over ownership to someone else (separately from your Azure AD tenant), you should delete it from your Azure AD tenant prior to expiring or transferring.
96+
* If you do allow your domain name to expire, if you are able to reactivate it/regain control of it, carefully review all TXT records with the registrar to ensure no tampering of your domain name took place.
97+
* If you can't reactivate or regain control of your domain name immediately, you should delete it from your Azure AD tenant. Dom't readd/re-verify until you are able to resolve ownership of the domain name and verify the full TXT record for correctness.
98+
99+
>[!NOTE]
100+
> Microsoft will not allow a domain name to be verified with more than Azure AD tenant. Once you delete a domain name from your tenant, you will not be able to re-add/re-verify it with your Azure AD tenant if it is subsequently added and verified with another Azure AD tenant.
101+
102+
## Frequently asked questions
91103

92104
**Q: Why is the domain deletion failing with an error that states that I have Exchange mastered groups on this domain name?** <br>
93-
**A:** Today, certain groups like Mail-Enabled Security groups and distributed lists are provisioned by Exchange and need to be manually cleaned up in [Exchange Admin Center (EAC)](https://outlook.office365.com/ecp/). There may be lingering ProxyAddresses which rely on the custom domain name and will need to be updated manually to another domain name.
105+
**A:** Today, certain groups like Mail-Enabled Security groups and distributed lists are provisioned by Exchange and need to be manually cleaned up in [Exchange Admin Center (EAC)](https://outlook.office365.com/ecp/). There may be lingering ProxyAddresses, which rely on the custom domain name and will need to be updated manually to another domain name.
94106

95107
**Q: I am logged in as admin\@contoso.com but I cannot delete the domain name “contoso.com”?**<br>
96-
**A:** You cannot reference the custom domain name you are trying to delete in your user account name. Ensure that the Global Administrator account is using the initial default domain name (.onmicrosoft.com) such as [email protected]. Sign in with a different Global Administrator account that such as [email protected] or another custom domain name like “fabrikam.com” where the account is [email protected].
108+
**A:** You can't reference the custom domain name you are trying to delete in your user account name. Ensure that the Global Administrator account is using the initial default domain name (.onmicrosoft.com) such as [email protected]. Sign in with a different Global Administrator account that such as [email protected] or another custom domain name like “fabrikam.com” where the account is [email protected].
97109

98110
**Q: I clicked the Delete domain button and see `In Progress` status for the Delete operation. How long does it take? What happens if it fails?**<br>
99-
**A:** The delete domain operation is an asynchronous background task that renames all references to the domain name. It should complete within a minute or two. If domain deletion fails, ensure that you don’t have:
111+
**A:** The delete domain operation is an asynchronous background task that renames all references to the domain name. It may take up to 24 hours to complete. If domain deletion fails, ensure that you don’t have:
100112

101113
* Apps configured on the domain name with the appIdentifierURI
102114
* Any mail-enabled group referencing the custom domain name
103115
* More than 1000 references to the domain name
116+
* The domain to be removed the set as the Primary domain of your organization
104117

105-
If you find that any of the conditions haven’t been met, manually clean up the references and try to delete the domain again.
118+
Also note that the ForceDelete option won't work if the domain uses Federated authentication type. In that case the users/groups on the domain must be renamed or removed using the on-premises Active Directory before reattempting the domain removal.
119+
If you find that any of the conditions haven’t been met, manually clean up the references, and try to delete the domain again.
106120

107121
## Use PowerShell or the Microsoft Graph API to manage domain names
108122

0 commit comments

Comments
 (0)