属于 Microsoft Entra 的 Microsoft Entra ID 支持批量用户创建和删除操作,并支持下载用户列表。 只需填写一个逗号分隔值 (CSV) 模板,可从 Microsoft Entra ID 下载该模板。
所需的权限
若要在管理门户中批量创建用户,必须至少以用户管理员身份登录。
了解 CSV 模板
下载并填写批量上传 CSV 模板,该模板可帮助你成功批量创建 Microsoft Entra 用户。 下载的 CSV 模板可能如下例所示:
警告
如果要使用 CSV 模板仅添加一个条目,则必须保留第 3 行并将新条目添加到第 4 行。
确保添加 .csv 文件扩展名并删除 userPrincipalName、passwordProfile 和 accountEnabled 之前的所有前导空格。
CSV 模板结构
下载的 CSV 模板中的行如下所示:
-
版本号:包含版本号的第一行(例如,
version:v1.0)必须包含在上传 CSV 中。 如果下载的模板包含此行,请不要删除或修改它。 -
列标题:列标题的格式为:<项名称> [PropertyName] <必需或空白>。 例如,
Name [displayName] Required。 某些较旧版本的模板可能会略有不同。 - 示例行:模板可能包含每个列的示例值行。 必须删除示例行并将其替换为你自己的项。
注意
CSV 模板格式因操作而异。 某些模板(如批量创建或删除用户)在第一行包含version:v1.0,而其他模板(如组成员操作)则直接以列标题开头。 请始终使用直接从门户下载的模板来执行特定操作,并且不要修改首行。
其他指南
- 上传模板的第一行不得删除或修改,否则将无法处理上传。
- 必须的列会被优先列出。
- 建议不要将新列添加到模板。 所添加的任何其他列都会被忽略,不进行处理。
- 建议尽可能经常下载 CSV 模板的最新版本。
- 请检查确保字段前后没有不必要的空格。 对于“用户主体名称”,存在此类空格会导致导入失败。
- 确保“初始密码”中的值符合当前活动的密码策略。
- 每行输入一个用户。
示例 CSV 文件
下面是准备好上传的已完成 CSV 文件的示例:
version:v1.0
Name [displayName] Required,User name [userPrincipalName] Required,Initial password [passwordProfile] Required,Block sign in (Yes/No) [accountEnabled] Required,First name [givenName],Last name [surname],Job title [jobTitle],Department [department],Usage location [usageLocation],Street address [streetAddress],State or province [state],Country or region [country],Office [physicalDeliveryOfficeName],City [city],ZIP or postal code [postalCode],Office phone [telephoneNumber],Mobile phone [mobile]
Alain Charon,alain@contoso.com,Password1!,No,Alain,Charon,Software Engineer,Engineering,US,,,,,,,
Isabella Simonsen,isabella@contoso.com,Password1!,No,Isabella,Simonsen,Product Manager,Product,US,,,,,,,
Joseph Price,joseph@contoso.com,Password1!,No,Joseph,Price,Sales Representative,Sales,US,,,,,,,
重要
只需要前四列: 名称、 用户名、 初始密码和 阻止登录。 所有其他列都是可选的,可以留空。
批量创建用户
至少以用户管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>用户>批量创建。
在“批量创建用户”页上,选择“下载”,以接收用户属性的有效逗号分隔值 (CSV) 文件,然后添加要创建的用户。
打开 CSV 文件,并为每个要创建的用户添加一行。 只有“名称”、“用户主体名称”、“初始密码”和“阻止登录(是/否)”为必填项。 然后保存文件。
在“批量创建用户”页中,在“上传 CSV 文件”下,浏览到该文件。 选择该文件并选择“提交”后,将启动对 CSV 文件的验证。
验证文件内容后,会看到“文件上传成功”的消息。 如果有错误,必须修正错误,然后才能提交作业。
文件通过验证后,请选择“提交”,以启动将导入新用户的批量操作。
导入操作完成后,系统会显示一条通知,指示批量操作作业状态。
如果遇到错误,可以在“批量操作结果”页下载并查看结果文件。 该文件包含每个错误的原因。 文件提交必须与提供的模板匹配,并包含确切的列名称。
有关批量操作限制的详细信息,请参阅批量导入服务限制。
查看状态
可在“批量操作结果”页面中查看所有挂起的批量请求的状态。
接下来,可通过 Azure 门户或 PowerShell 查看已创建的用户是否存在于 Microsoft Entra 组织中。
验证用户
- 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
- 选择“Microsoft Entra ID”。
- 选择“所有用户”>“用户”。
- 在“显示”下选择“所有用户”,并验证创建的用户是否已列出。
使用 PowerShell 验证用户
运行以下命令:
Get-MgUser -Filter "UserType eq 'Member'"
应会看到你创建的用户已列出。
批量导入服务限制
注意
执行批量作(如导入或创建)时,如果批量作在一小时内未完成,则可能会遇到问题。 若要解决此问题,建议拆分每批处理的记录数。 例如,在开始导出之前,可以通过筛选组类型或用户名来限制结果集,以减少结果的大小。 通过优化筛选器,你本质上是在限制批量操作返回的数据。 有关详细信息,请参阅批量操作服务限制。