Microsoft Entra ID에 그룹 멤버 대량 추가

CSV(쉼표로 구분된 값) 파일을 사용하여 그룹에 여러 멤버를 추가하여 Microsoft Entra ID에 대한 포털에서 그룹 구성원을 대량으로 가져올 수 있습니다.

CSV 템플릿 이해

대량 업로드 CSV 템플릿을 다운로드하고 작성하여 대량으로 Microsoft Entra 그룹 멤버를 추가합니다. 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.

대량 작업 내의 각 줄 항목에 대한 자세한 내용을 보려면 # Success, # Failure 또는 Total Requests 열의 값을 선택합니다. 오류가 발생한 경우 실패 이유가 나열됩니다.

대량 가져오기 서비스 제한

그룹 구성원 목록을 가져오는 각 대량 활동은 최대 1시간 동안 실행될 수 있습니다. 이 시간 프레임을 사용하면 최대 40,000명의 멤버 목록을 가져올 수 있습니다.

다음 단계