Microsoft Entra ID에 그룹 멤버 대량 추가
Microsoft Entra ID 포털에서 CSV(쉼표로 구분된 값) 파일을 사용하여 그룹 멤버를 대량으로 가져오면 그룹에 여러 멤버를 추가할 수 있습니다.
CSV 템플릿 이해
대량 업로드 CSV 템플릿을 다운로드하고 작성하여 대량으로 Microsoft Entra 그룹 멤버를 추가합니다. CSV 템플릿은 다음 예와 비슷합니다.
CSV 템플릿 구조
다운로드한 CSV 템플릿의 행은 다음과 같습니다.
- 버전 번호: 버전 번호가 포함된 첫 번째 행이 업로드 CSV에 포함되어야 합니다.
- 열 머리글: 열 머리글 형식은 <항목 이름> [PropertyName] < 필수 또는 비워둠 >입니다. 예제는
Member object ID or user principal name [memberObjectIdOrUpn] Required입니다. 템플릿의 일부 이전 버전은 약간 다를 수 있습니다. 그룹 멤버 자격 변경의 경우 멤버 자격 개체 ID 또는 사용자 계정 이름을 선택할 수 있습니다. - 예 행: 템플릿에는 각 열에 허용되는 값의 예 행이 포함되어 있습니다. 예제 행을 제거하고 원하는 항목으로 바꾸어야 합니다.
추가 지침
- 업로드 템플릿의 처음 두 행은 제거하거나 수정하면 안 됩니다. 제거하거나 수정하면 업로드를 처리할 수 없습니다.
- 필수 열이 먼저 나열됩니다.
- 템플릿에 새 열을 추가하지 않는 것이 좋습니다. 새로 추가하는 다른 모든 열은 무시되고 처리되지 않습니다.
- 가능한 자주 최신 버전의 CSV 템플릿을 다운로드하는 것이 좋습니다.
- 파일을 성공적으로 업로드하려면 사용자의 UPN 또는 개체 ID를 두 개 이상 추가합니다.
그룹 멤버 대량 가져오기
팁
이 문서의 단계는 시작하는 포털에 따라 약간 다를 수도 있습니다.
최소한 그룹 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
Microsoft Entra ID를 선택합니다.
참고 항목
그룹 소유자는 또한 소유한 그룹의 구성원을 대량으로 가져올 수 있습니다.
그룹>모든 그룹을 선택합니다.
구성원을 추가할 그룹을 열고 구성원을 선택합니다.
구성원 페이지에서 대량 작업을 선택한 다음 구성원 가져오기를 선택합니다.
그룹 구성원 대량 가져오기 페이지에서 다운로드를 선택하여 필요한 그룹 구성원 속성이 적용된 CSV 파일 템플릿을 가져옵니다.
CSV 파일을 열고 그룹으로 가져오려는 각 그룹 멤버에 대한 줄을 추가합니다. 필수 값은 멤버 개체 ID 또는 사용자 계정 이름입니다. 그런 다음, 파일을 저장합니다.
그룹 구성원 대량 가져오기 페이지의 csv 파일 업로드에서 해당 파일을 찾습니다. 파일을 선택하면 CSV 파일의 유효성 검사가 시작됩니다.
파일 콘텐츠의 유효성 검사가 완료되면 대량 가져오기 페이지에 파일 업로드 성공이 표시됩니다. 오류가 있는 경우 해당 오류를 해결해야 작업을 제출할 수 있습니다.
파일이 유효성 검사를 통과하면 제출을 선택하여 그룹으로 그룹 구성원을 가져오는 대량 작업을 시작합니다.
가져오기 작업이 완료되면 대량 작업이 성공했다는 알림이 표시됩니다.
오류가 발생하면 대량 작업 결과 페이지에서 결과 파일을 다운로드하여 볼 수 있습니다. 해당 파일에는 각 오류에 대한 이유가 포함되어 있습니다. 파일 제출은 제공된 템플릿과 일치하고 정확한 열 이름을 포함해야 합니다. 대량 작업 제한에 대한 자세한 내용은 대량 가져오기 서비스 제한을 참조 하세요.
가져오기 상태 확인
대량 작업 결과 페이지에서 대기 중인 모든 대량 요청의 상태를 확인할 수 있습니다.
대량 작업 내의 각 줄 항목에 대한 자세한 내용을 보려면 # Success, # Failure 또는 Total Requests 열의 값을 선택합니다. 실패가 발생한 경우 실패 이유가 나열됩니다.
대량 가져오기 서비스 제한
참고 항목
가져오기, 만들기 등의 대량 작업을 수행할 때 대량 작업이 1시간 내에 완료되지 않으면 문제가 발생할 수 있습니다. 이 문제를 해결하려면 일괄 처리당 처리되는 레코드 수를 분할하는 것이 좋습니다. 예를 들어, 내보내기를 시작하기 전에 그룹 유형이나 사용자 이름을 필터링하여 결과 집합을 제한하여 결과 크기를 줄일 수 있습니다. 필터를 세부화하면 본질적으로 대량 작업에서 반환되는 데이터가 제한됩니다. 자세한 내용은 대량 작업 서비스 제한 사항을 참조하세요.