Skip to content

Commit c4ba04a

Browse files
authored
Merge pull request #232413 from v-edmckillop/patch-152
Update clean-up-unmanaged-azure-ad-accounts.md
2 parents 54efc1b + 7f0b3ae commit c4ba04a

File tree

1 file changed

+35
-38
lines changed

1 file changed

+35
-38
lines changed
Lines changed: 35 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Clean up unmanaged Azure AD accounts
3-
description: Clean up unmanaged accounts using email OTP and PowerShell modules in Azure Active Directory
2+
title: Clean up unmanaged Azure Active Directory accounts
3+
description: Clean up unmanaged accounts using email one-time password and PowerShell modules in Azure AD
44
services: active-directory
55
author: gargi-sinha
66
ms.author: gasinh
77
manager: martinco
8-
ms.date: 06/28/2022
8+
ms.date: 03/28/2023
99
ms.topic: how-to
1010
ms.service: active-directory
1111
ms.subservice: enterprise-users
@@ -16,68 +16,65 @@ ms.collection: M365-identity-device-management
1616

1717
# Clean up unmanaged Azure Active Directory accounts
1818

19-
Prior to August 2022, Azure AD B2B supported Self-service sign-up for email-verified users which allowed users to create Azure AD accounts if they can verify ownership of the email. These accounts were created in unmanaged (aka “viral) tenants. This meant that the user created an account with an organization’s domain that is not under the lifecycle management of the organization’s IT and access can persist after the user leaves the organization. To learn more, see, [What is self-service sign-up for Azure Active Directory?](./directory-self-service-signup.md)
19+
Prior to August 2022, Azure Active Directory B2B (Azure AD B2B) supported self-service sign-up for email-verified users. With this feature, users create Azure AD accounts, when they verify email ownership. These accounts were created in unmanaged (or viral) tenants: users created accounts with an organization domain, not under IT team management. Access persists after users leave the organization.
2020

21-
The creation of unmanaged Azure AD accounts via Azure AD B2B is now deprecated and new B2B invitations cannot be redeemed with these accounts as of August 2022. However, invitations sent prior to August 2022 could have been redeemed with unmanaged Azure AD accounts.
21+
To learn more, see, [What is self-service sign-up for Azure AD?](./directory-self-service-signup.md)
22+
23+
> [!NOTE]
24+
> Unmanaged Azure AD accounts via Azure AD B2B were deprecated. As of August 2022, new B2B invitations can't be redeemed. However, invitations prior to August 2022 were redeemable with unmanaged Azure AD accounts.
2225
2326
## Remove unmanaged Azure AD accounts
2427

25-
Admins can use either this sample application in [Azure-samples/Remove-unmanaged-guests](https://github.com/Azure-Samples/Remove-Unmanaged-Guests) or PowerShell cmdlets in [AzureAD/MSIdentityTools](https://github.com/AzureAD/MSIdentityTools/wiki/) to remove existing unmanaged Azure AD accounts from your Azure AD tenants. These tools allow you to identify viral users in your Azure AD tenant and reset the redemption status of these users.
28+
Use the following guidance to remove unmanaged Azure AD accounts from Azure AD tenants. Tool features help identify viral users in the Azure AD tenant. You can reset the user redemption status.
29+
30+
* Use the sample application in [Azure-samples/Remove-unmanaged-guests](https://github.com/Azure-Samples/Remove-Unmanaged-Guests)
31+
* Use PowerShell cmdlets in [AzureAD/MSIdentityTools](https://github.com/AzureAD/MSIdentityTools/wiki/)
2632

27-
Once you have run one of the available tools, when users with unmanaged Azure AD accounts try to access your tenant, they will re-redeem their invitations. However, Azure AD will prevent users from redeeming with an existing unmanaged Azure AD account and they’ll redeem with another account type. Google Federation and SAML/WS-Fed are not enabled by default. So by default, these users will redeem with either an MSA or Email OTP, with MSA taking precedence. For a full explanation on the B2B redemption precedence, refer to the [redemption precedence flow chart](../external-identities/redemption-experience.md#invitation-redemption-flow).
33+
After you run a tool, users with unmanaged Azure AD accounts access the tenant, and re-redeem their invitations. However, Azure AD prevents users from redeeming with an unmanaged Azure AD account. They can redeem with another account type. Google Federation and SAML/WS-Federation aren't enabled by default. Therefore, users redeem with a Microsoft account (MSA) or email one-time password (OTP). MSA is recommended.
34+
35+
Learn more: [Invitation redemption flow](../external-identities/redemption-experience.md#invitation-redemption-flow)
2836

2937
## Overtaken tenants and domains
3038

31-
Some tenants created as unmanaged tenants can be taken over and
32-
converted to a managed tenant. See, [take over an unmanaged directory as
33-
administrator in Azure AD](./domains-admin-takeover.md).
39+
It's possible to convert some unmanaged tenants to managed tenants.
3440

35-
In some cases, overtaken domains might not be updated, for example, missing a DNS TXT record and therefore become flagged as unmanaged. Implications are:
41+
Learn more: [Take over an unmanaged directory as administrator in Azure AD](./domains-admin-takeover.md)
3642

37-
- For guest users who belong to formerly unmanaged tenants, redemption status is reset and one consent prompt appears. Redemption occurs with same account as before.
43+
Some overtaken domains might not be updated. For example, a missing DNS TXT record indicates an unmanaged state. Implications are:
3844

39-
- After unmanaged user redemption status is reset, the tool might identify unmanaged users that are false positives.
45+
* For guest users from unmanaged tenants, redemption status is reset. A consent prompt appears.
46+
* Redemption occurs with same account
47+
* The tool might identify unmanaged users as false positives after you reset unmanaged user redemption status
4048

41-
## Reset redemption using a sample application
49+
## Reset redemption with a sample application
4250

43-
Use the sample application on
44-
[Azure-Samples/Remove-Unmanaged-Guests](https://github.com/Azure-Samples/Remove-Unmanaged-Guests).
51+
Use the sample application on [Azure-Samples/Remove-Unmanaged-Guests](https://github.com/Azure-Samples/Remove-Unmanaged-Guests).
4552

4653
## Reset redemption using MSIdentityTools PowerShell Module
4754

48-
MSIdentityTools PowerShell Module is a collection of cmdlets and
49-
scripts. They are for use in the Microsoft identity platform and Azure
50-
AD; they augment capabilities in the PowerShell SDK. See, [Microsoft
51-
Graph PowerShell
52-
SDK](https://github.com/microsoftgraph/msgraph-sdk-powershell).
55+
MSIdentityTools PowerShell Module is a collection of cmdlets and scripts, which you use in the Microsoft identity platform and Azure AD. Use the cmdlets and scripts to augment PowerShell SDK capabilities. See, [microsoftgraph/msgraph-sdk-powershell](https://github.com/microsoftgraph/msgraph-sdk-powershell).
5356

5457
Run the following cmdlets:
5558

56-
- `Install-Module Microsoft.Graph -Scope CurrentUser`
57-
58-
- `Install-Module MSIdentityTools`
59-
60-
- `Import-Module msidentitytools,microsoft.graph`
59+
* `Install-Module Microsoft.Graph -Scope CurrentUser`
60+
* `Install-Module MSIdentityTools`
61+
* `Import-Module msidentitytools,microsoft.graph`
6162

6263
To identify unmanaged Azure AD accounts, run:
6364

64-
- `Connect-MgGraph -Scope User.ReadAll`
65-
66-
- `Get-MsIdUnmanagedExternalUser`
65+
* `Connect-MgGraph -Scope User.ReadAll`
66+
* `Get-MsIdUnmanagedExternalUser`
6767

6868
To reset unmanaged Azure AD account redemption status, run:
6969

70-
- `Connect-MgGraph -Scopes User.ReadWriteAll`
71-
72-
- `Get-MsIdUnmanagedExternalUser | Reset-MsIdExternalUser`
70+
* `Connect-MgGraph -Scopes User.ReadWriteAll`
71+
* `Get-MsIdUnmanagedExternalUser | Reset-MsIdExternalUser`
7372

7473
To delete unmanaged Azure AD accounts, run:
7574

76-
- `Connect-MgGraph -Scopes User.ReadWriteAll`
77-
78-
- `Get-MsIdUnmanagedExternalUser | Remove-MgUser`
75+
* `Connect-MgGraph -Scopes User.ReadWriteAll`
76+
* `Get-MsIdUnmanagedExternalUser | Remove-MgUser`
7977

80-
## Next steps
78+
## Resources
8179

82-
Examples of using
83-
[Get-MSIdUnmanagedExternalUser](https://github.com/AzureAD/MSIdentityTools/wiki/Get-MsIdUnmanagedExternalUser)
80+
See, [Get-MSIdUnmanagedExternalUser](https://github.com/AzureAD/MSIdentityTools/wiki/Get-MsIdUnmanagedExternalUser). The tool returns a list of external unmanaged users, or viral users, in the tenant.

0 commit comments

Comments
 (0)