在 Microsoft Entra ID 中批量添加组成员

  • 项目

可以使用逗号分隔值 (CSV) 文件将多个成员添加到组，以便在 Microsoft Entra ID 的门户中批量导入组成员。

了解 CSV 模板

要成功地批量添加 Microsoft Entra 组成员，请下载并填写“批量上传 CSV”模板。 CSV 模板可能如下例所示：

Screenshot that shows the spreadsheet for upload and call-outs explaining the purpose and values for each row and column.

CSV 模板结构

下载的 CSV 模板中的行如下所示：

  • 版本号：包含版本号的第一行必须包含在上传的 CSV 中。
  • 列标题：列标题的格式为：<项名称> [PropertyName] <必需或空白>。 示例为 Member object ID or user principal name [memberObjectIdOrUpn] Required。 某些较旧版本的模板可能会略有不同。 对于组成员身份更改，可以选择成员对象 ID 或用户主体名称。
  • 示例行：模板包含了一行示例，展示了每个列的可接受值。 必须删除示例行并将其替换为你自己的项。

更多指导

  • 不得删除或修改上传模板的前两行，否则无法处理上传。
  • 所需的列会先列出。
  • 建议不要将新列添加到模板。 所添加的任何其他列都会被忽略，不作处理。
  • 建议尽可能频繁地下载 CSV 模板的最新版本。
  • 添加至少两个用户的 UPN 或对象 ID 以成功上传文件。

批量导入组成员

提示

本文中的步骤可能因开始使用的门户而略有不同。

  1. 至少以全局管理员身份登录到 Microsoft Entra 管理中心。

  2. 选择“Microsoft Entra ID”。

    注意

    组所有者还可批量导入其拥有的组的成员。

  3. 选择“组”>“所有组” 。

  4. 打开要向其添加成员的组，然后选择“成员”。

  5. 在“成员”页上，选择“批量操作”，然后选择“导入成员”。

  6. 在“批量导入组成员”页面上，选择“下载”以获取具有所需组成员属性的 CSV 文件模板 。

    Screenshot that shows the Import Members command is on the profile page for the group.

  7. 打开 CSV 文件，为要导入到组中的每个组成员添加一行。 所需值为“成员对象 ID”或“用户主体名称”。 然后保存文件。

    Screenshot that shows the CSV file contains names and IDs of the members to import.

  8. 在“批量导入组成员”页面上的“上传 csv 文件”下，浏览到该文件 。 选择 CSV 文件后立即开始对它的验证。

  9. 验证文件内容后，批量导入页将显示“已成功上传文件”。 如果有错误，必须修正错误，然后才能提交作业。

  10. 当文件通过验证时，选择“提交”，开始将组成员导入到组的批量操作。

  11. 导入操作完成后，会显示一条通知，提示批量操作成功。

查看导入状态

可在“批量操作结果”页面中查看所有挂起的批量请求的状态。

Screenshot that shows the Check status option on the Bulk operation results page.

要详细了解批量操作中每个行项，请选择“成功数”、“失败数”或“请求总数”列下的值 。 如果失败，则会列出失败原因。

“批量导入”服务限制

导入组成员列表的每个批量活动最多可运行一小时。 在该期限内，可导入至多包含 40000 名成员的列表。

后续步骤