-
Notifications
You must be signed in to change notification settings - Fork 908
Expand file tree
/
Copy pathhow-to-create-delete-users.yml
More file actions
264 lines (189 loc) · 17.8 KB
/
how-to-create-delete-users.yml
File metadata and controls
264 lines (189 loc) · 17.8 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
### YamlMime:HowTo
metadata:
title: How to create or delete users in Microsoft Entra ID
description: Instructions for IT admins to create new users and delete or update existing users in Microsoft Entra ID.
author: shlipsey3
ms.author: sarahlipsey
ms.reviewer: adelle.dimitui
ms.date: 03/17/2025
ms.service: entra
ms.subservice: fundamentals
ms.topic: how-to
ms.custom:
- ge-structured-content-pilot
- sfi-image-nochange
# Customer intent: As an IT admin, I need to know how to create, update, and delete users manually for quick, one-off updates.
title: |
How to create, invite, and delete users
introduction: |
Microsoft Entra ID allows you to create several types of users in your tenant, which provides greater flexibility in how you manage your organization's users.
This article explains how to create a new user, invite an external guest, and delete a user in your workforce tenant. It also includes information about creating users in an external tenant for [Microsoft Entra External ID](~/external-id/customers/overview-customers-ciam.md) scenarios.
[!INCLUDE [GDPR-related guidance](~/includes/azure-docs-pr/gdpr-hybrid-note.md)]
## Types of users
Before you create or invite a new user, take some time to review the types of users, their authentication methods, and their access within your Microsoft Entra workforce tenant. For example, do you need to create an internal guest, an internal user, or an external guest? Does your new user need guest or member privileges?
### Users in workforce tenants
A Microsoft Entra workforce tenant has the following user types:
- **Internal member**: These users are most likely full-time employees in your organization.
- **Internal guest**: These users have an account in your tenant, but have guest-level privileges. It's possible they were created within your tenant prior to the availability of B2B collaboration.
- **External member**: These users authenticate using an external account, but have member access to your tenant. These types of users are common in [multitenant organizations](../identity/multi-tenant-organizations/overview.md#what-is-the-multitenant-organization-scenario).
- **External guest**: These users are true guests of your tenant who authenticate using an external method and who have guest-level privileges.
For more information about the differences between internal and external guests and members, see [B2B collaboration properties](~/external-id/user-properties.md).
Authentication methods vary based on the type of user you create. Internal guests and members have credentials in your Microsoft Entra tenant that can be managed by administrators. These users can also reset their own password. External members authenticate to their home Microsoft Entra tenant and your Microsoft Entra tenant authenticates the user through a federated sign-in with the external member's Microsoft Entra tenant. If external members forget their password, the administrator in their Microsoft Entra tenant can reset their password. External guests set up their own password using the link they receive in email when their account is created.
Reviewing the default user permissions may also help you determine the type of user you need to create. For more information, see [Set default user permissions](users-default-permissions.md).
### Users in external tenants
A Microsoft Entra tenant in an *external* configuration is used exclusively for [Microsoft Entra External ID](~/external-id/customers/overview-customers-ciam.md) scenarios. An external tenant can include the following user types:
- **Internal user**: These users authenticate internally, and are typically admins with assigned [Microsoft Entra roles](~/identity/role-based-access-control/permissions-reference.md) in your external tenant.
- **External user**: These users are consumers and business customers of the apps registered in your external tenant. They have a local account with [default user privileges](~/external-id/customers/reference-user-permissions.md) and authenticate via a local account or via external identity providers. See how to [create a new external user](#create-a-new-external-user).
- **External guest**: These users sign in with their own external credentials and are typically admins with assigned [Microsoft Entra roles](~/identity/role-based-access-control/permissions-reference.md) in your external tenant.
For more information, see [Default user permissions](~/external-id/customers/reference-user-permissions.md) for external tenants.
prerequisites:
summary: |
The required role of least privilege varies based on the type of user you're adding and if you need to assign Microsoft Entra roles at the same time. Whenever possible you should use the least privileged role.
| Task | Role |
| -- | -- |
| Create a new user | User Administrator |
| Invite an external guest | Guest Inviter |
| Assign Microsoft Entra roles | Privileged Role Administrator |
procedureSection:
- title: |
Create a new user
summary: |
Follow these steps:
steps:
- |
Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [User Administrator](../identity/role-based-access-control/permissions-reference.md#user-administrator).
- |
Browse to **Entra ID** > **Users**.
:::image type="content" source="media/how-to-create-delete-users/all-users-page.png" alt-text="Screenshot of the All users page in Microsoft Entra ID.":::
- |
Select **New user** > **Create new user**.
:::image type="content" source="media/how-to-create-delete-users/create-new-user-menu.png" alt-text="Screenshot of the create new user menu in Microsoft Entra ID.":::
- |
Complete the remaining tabs in the **New user** page.
### Basics
The **Basics** tab contains the core fields required to create a new user. Before you begin, [review the guidance on user name properties](how-to-manage-user-profile-info.md#guidance-on-user-name-properties).
- **User principal name**: Enter a unique username and select a domain from the menu after the @ symbol. Select **Domain not listed** if you need to create a new domain. For more information, see [Add your custom domain name](add-custom-domain.md).
- **Mail nickname**: If you need to enter an email nickname that is different from the user principal name you entered, uncheck the **Derive from user principal name** option, then enter the mail nickname.
- **Display name**: Enter the user's name, such as Chris Green or Chris A. Green
- **Password**: Provide a password for the user to use during their initial sign-in. Uncheck the **Auto-generate password** option to enter a different password.
- **Account enabled**: This option is checked by default. Uncheck to prevent the new user from being able to sign-in. You can change this setting after the user is created. This setting was called **Block sign in** in the legacy create user process.
Either select the **Review + create** button to create the new user or **Next: Properties** to complete the next section.
:::image type="content" source="media/how-to-create-delete-users/create-new-user-basics-tab.png" alt-text="Screenshot of the create new user Basics tab.":::
Either select the **Review + create** button to create the new user or **Next: Properties** to complete the next section.
### Properties
There are six categories of user properties you can provide. These properties can be added or updated after the user is created. To manage these details, go to **Entra ID** > **Users** and select a user to update.
- **Identity:** Enter the user's first and last name. Set the User type as either Member or Guest.
- **Job information:** Add any job-related information, such as the user's job title, department, or manager.
- **Contact information:** Add any relevant contact information for the user.
- **Parental controls:** For organizations like K-12 school districts, the user's age group may need to be provided. *Minors* are 12 and under, *Not adult* are 13-18 years old, and *Adults* are 18 and over. The combination of age group and consent provided by parent options determine the Legal age group classification. The Legal age group classification may limit the user's access and authority.
- **Settings:** Specify the user's global location.
Either select the **Review + create** button to create the new user or **Next: Assignments** to complete the next section.
### Assignments
You can assign the user to an administrative unit, group, or Microsoft Entra role when the account is created. You can assign the user to up to 20 groups or roles. You can only assign the user to one administrative unit. Assignments can be added after the user is created.
**To assign a group to the new user**:
1. Select **+ Add group**.
1. From the menu that appears, choose up to 20 groups from the list and select the **Select** button.
1. Select the **Review + create** button.
:::image type="content" source="media/how-to-create-delete-users/add-group-assignment.png" alt-text="Screenshot of the add group assignment process.":::
**To assign a role to the new user**:
1. Select **+ Add role**.
1. From the menu that appears, choose up to 20 roles from the list and select the **Select** button.
1. Select the **Review + create** button.
**To add an administrative unit to the new user**:
1. Select **+ Add administrative unit**.
1. From the menu that appears, choose one administrative unit from the list and select the **Select** button.
1. Select the **Review + create** button.
### Review and create
The final tab captures several key details from the user creation process. Review the details and select the **Create** button if everything looks good.
- title: |
Create a new external user
summary: |
> [!IMPORTANT]
> These steps apply to [Microsoft Entra External ID](~/external-id/customers/overview-customers-ciam.md) external tenants only.
steps:
- |
Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [User Administrator](../identity/role-based-access-control/permissions-reference.md#user-administrator).
- |
Make sure you're signed in to your external tenant. Use the **Settings** icon :::image type="icon" source="media/how-to-create-delete-users/admin-center-settings-icon.png" border="false"::: in the top menu to switch to your external tenant from the **Directories + subscriptions** menu.
- |
Browse to **Entra ID** > **Users**.
- |
Select **New user** > **Create new external user**.
:::image type="content" source="media/how-to-create-delete-users/create-new-external-user-menu.png" alt-text="Screenshot of the create new external user menu in Microsoft Entra ID.":::
- |
On the **Create new user** page, complete the [Basics](#basics) tab as described earlier in this article, but with these variations:
- Instead of a user principal name and mail nickname, specify the user's email for sign-in. Next to **Identities**, under **Sign-in method**, choose **Email**. Under **Value**, enter the user's email address.
- To add multiple emails for the user, select the **Add** button.
- |
(Optional) Select **Next: Properties**. Complete the [Properties](#properties) tab as described earlier in this article, but note these variations:
- In the **Identity** section, the **User type** setting doesn't affect external users and can be left at the default **Member** setting.
- The **Authorization info** field is unavailable for external users.
- Under **Job Information**, the employee and manager-related information is unavailable for external users.
- |
(Optional) Select **Next: Assignments**. Complete the [Assignments](#assignments) tab as described earlier in this article, but note that the **Add administrative unit** and **Add role** options are unavailable for external users.
- |
Select the **Review + create** button to create the new user.
- title: |
Invite an external user
summary: |
The overall process for inviting an external guest user is similar, except for a few details on the **Basics** tab and the email invitation process. You can't assign external users to administrative units.
> [!NOTE]
> This feature applies to both workforce and external tenants, but is currently in preview for external tenants.
steps:
- |
Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [User Administrator](~/identity/role-based-access-control/permissions-reference.md#user-administrator).
- |
Browse to **Entra ID** > **Users**.
- |
Select **New user** > **Invite external user**.
:::image type="content" source="media/how-to-create-delete-users/invite-external-user-menu.png" alt-text="Screenshot of the invite external user menu option.":::
- |
Complete the remaining tabs in the **New user** page (as shown below).
### Basics for external users
In this section, you're inviting the guest to your tenant using *their email address*. If you need to create a guest user with a domain account, use the [create new user process](#create-a-new-user) but change the **User type** to **Guest**.
- **Email**: Enter the email address for the guest user you're inviting.
- **Display name**: Provide the display name.
- **Invitation message**: Select the **Send invite message** checkbox to customize a brief message to the guest. Provide a Cc recipient, if necessary.
:::image type="content" source="media/how-to-create-delete-users/invite-external-user-basics-tab.png" alt-text="Screenshot of the invite external user Basics tab.":::
### Guest user invitations
When you invite an external guest user by sending an email invitation, you can check the status of the invitation from the user's details.
1. Browse to **Entra ID** > **Users**.
1. Select the invited guest user.
1. In the **My Feed** section, locate the **B2B collaboration** tile.
- If the invitation state is **PendingAcceptance**, select the **Resend invitation** link to send another email.
- You can also select the **Properties** for the user and view the **Invitation state**.
:::image type="content" source="media/how-to-create-delete-users/external-user-invitation-state.png" alt-text="Screenshot of the user details with the invitation status options highlighted.":::
## Add other users
There might be scenarios in which you want to manually create consumer accounts in your Azure Active Directory B2C (Azure AD B2C) directory. For more information about creating consumer accounts, see [Create and delete consumer users in Azure AD B2C](/azure/active-directory-b2c/manage-users-portal).
[!INCLUDE [active-directory-b2c-end-of-sale-notice.md](~/includes/active-directory-b2c-end-of-sale-notice.md)]
If you have an environment with both Microsoft Entra ID (cloud) and Windows Server Active Directory (on-premises), you can add new users by syncing the existing user account data. For more information about hybrid environments and users, see [Integrate your on-premises directories with Microsoft Entra ID](~/identity/hybrid/whatis-hybrid-identity.md).
- title: |
Delete a user
summary: |
You can delete an existing user using the [Microsoft Entra admin center](https://entra.microsoft.com/).
steps:
- |
You must have at least the User Administrator role assignment to delete users in your organization.
- |
Those with the Privileged Authentication Administrator role can delete any users including other administrators.
- |
User Administrators can delete any non-admin users, Helpdesk Administrators, and other User Administrators.
- |
For more information, see [Administrator role permissions in Microsoft Entra ID](~/identity/role-based-access-control/permissions-reference.md).
To delete a user, follow these steps:
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [User Administrator](~/identity/role-based-access-control/permissions-reference.md#user-administrator).
1. Browse to **Entra ID** > **Users**.
1. Search for and select the user you want to delete.
1. Select **Delete user**.
:::image type="content" source="media/how-to-create-delete-users/delete-existing-user.png" alt-text="Screenshot of the All users page with a user selected and the Delete button highlighted.":::
The user is deleted and no longer appears on the **All users** page. The user can be seen on the **Deleted users** page for the next 30 days and can be restored during that time. For more information about restoring a user, see [Restore or remove a recently deleted user using Microsoft Entra ID](./users-restore.md).
When a user is deleted, any licenses consumed by the user are made available for other users.
> [!NOTE]
> To update the identity, contact information, or job information for users whose source of authority is Windows Server Active Directory, you must use Windows Server Active Directory. After you complete the update, you must wait for the next synchronization cycle to complete before you'll see the changes.
relatedContent:
- text: Learn about B2B collaboration users
url: ~/external-id/add-users-administrator.yml
- text: Review the default user permissions
url: users-default-permissions.md
- text: Add a custom domain
url: add-custom-domain.md