조직 데이터 가져오기

아티클
02/24/2025

사용자 프로필 및 다른 Microsoft 365 앱(예: Viva Insights)에서 사용하기 위해 비 Microsoft 시스템에서 Microsoft 365로 직원 정보를 가져올 수 있습니다. 조직 데이터라고 하는 이 정보는 Microsoft Entra ID(이전의 Azure Active Directory)의 정보와 함께 사용됩니다. (우선하는 데이터를 포함하여 두 정보 집합이 함께 작동하는 방법에 대한 자세한 내용은 데이터 사용량을 참조하세요.)

데이터를 가져오려면 포함하려는 사용자에 대한 특성(또는 정보)으로 .csv 템플릿을 채웁니다. 그런 다음 Microsoft 365 관리 센터 통해 파일을 업로드합니다. 시작하는 단계는 다음과 같습니다.

.csv 템플릿 다운로드
조직 데이터 구조화
처음으로 조직 데이터 가져오기
데이터 업데이트 또는 기타 변경

1단계 - .csv 템플릿 다운로드

전역 관리 권한이 있는 사용자로 Microsoft 365 관리 센터 로그인합니다.
Microsoft 365의 조직 데이터 페이지(마이그레이션 및 가져오기 설정>에서) 시작(데이터를 처음 가져오는 경우) 또는 새 가져오기를 선택합니다.
CSV 템플릿 다운로드를 선택합니다.

참고

조직 데이터 내보내기에서 설명한 대로 HR 소프트웨어와 같은 다른 시스템에서 내보낸 조직 데이터를 시작점으로 사용할 수도 있습니다.

2단계 - 조직 데이터 구조화

이제 .csv 파일 시작 지점이 있으므로 Microsoft 365에서 사용할 조직 데이터를 추가한 다음 파일을 저장합니다.

조직 데이터 파일에 추가할 수 있는 특성에는 필수 및 예약된 선택 사항의 두 가지 유형이 있습니다. 특성은 파일의 순서에 따라 다를 수 있습니다.

필수 - 기본적으로 필요한 유일한 특성은 이메일 주소입니다.
예약 - 특성은 현재 데이터를 계산하고, 필터링하고, 그룹화하는 데 사용되는 특성에 대한 예약 열 헤더입니다.

샘플 데이터 파일

다음은 유효한 .csv 파일의 예제 코드 조각입니다.

Microsoft_PersonEmail,Microsoft_ManagerEmail,Microsoft_LevelDesignation,Microsoft_Organization,Microsoft_Layer,Microsoft_CompanyOfficeCity
Emp1@contoso.com,Mgr1@contoso.com,Junior IC,Sales,8,Seattle
Emp2@contoso.com,Mgr1@contoso.com,Junior IC,Sales,8,Seattle
Emp3@contoso.com,Mgr2@contoso.com,Manager,Sales,7,Seattle
Emp4@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
Emp5@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
Emp6@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York

특성에 대한 자세한 내용은 특성 참조를 참조하세요.

3단계 - 처음으로 조직 데이터 가져오기

데이터를 사용하여 .csv 파일을 만든 후 다음 단계는 컴퓨터의 로컬 파일이나 SharePoint 사이트에서 데이터를 가져오는 것입니다.

컴퓨터의 로컬 파일에서 .csv 파일 업로드

데이터를 사용하여 .csv 파일을 만든 후 컴퓨터의 로컬 파일에서 직접 업로드할 수 있습니다.

참고

로컬 파일에서 직접 업로드된 파일에는 25MB 제한이 있습니다. .csv 파일이 더 큰 경우 먼저 SharePoint에 업로드 한 다음 해당 파일에서 가져옵니다.

스크린샷은 로컬 가져오기 옵션을 보여줍니다.

SharePoint에서 .csv 파일 업로드

먼저 로컬 컴퓨터에서 보안 SharePoint 위치로 파일을 업로드해야 합니다. 그런 다음 데이터를 가져옵니다.

SharePoint에 파일 업로드

다음 단계를 사용하여 SharePoint에 데이터를 업로드합니다. SharePoint 사이트에 올바른 권한이 있고 데이터에 액세스할 수 있어야 하는 권한만 사이트에 액세스할 수 있는지 확인합니다. 최대 5Gb 크기의 파일을 업로드할 수 있습니다.

SharePoint 사이트 라이브러리를 엽니다.
업로드를 선택한 다음 파일을 선택합니다.
.csv 파일을 저장한 위치로 이동한 다음 열기를 선택합니다.

끌어서 놓기를 사용하여 파일을 업로드할 수도 있습니다.

데이터를 Viva 가져오기 전에 SharePoint의 파일 경로(https:// domain.sharepoint.com/sites/sitename/Documents/foldername/파일 이름.csv 형식)가 필요합니다. 다음 단계를 사용하여 파일의 경로를 가져옵니다. 이 경로는 파일을 볼 때 브라우저에 표시되는 URL과 다릅니다.
파일 옆에 있는 타원(...)을 선택한 다음 세부 정보를 선택합니다.
경로 값을 찾은 다음 복사 아이콘을 선택합니다.

참고

파일의 경로를 얻으려면 다음 단계를 따라야 합니다. SharePoint에서 .csv 파일을 볼 때 브라우저의 URL 필드에 표시되는 것과는 다른 경로입니다.

Microsoft 365로 데이터 가져오기

이제 데이터를 가져올 준비가 되었습니다.

Microsoft 365의 조직 데이터 페이지(마이그레이션 및 가져오기 설정>에서) 시작(데이터를 처음 가져오는 경우) 또는 새 가져오기를 선택합니다.
SharePoint에서 데이터 가져오기 페이지에서 .csv 파일을 저장한 SharePoint 위치를 입력합니다. 업로드 단계가 끝날 때 위치를 복사한 경우 여기에 붙여넣습니다.
여기에서 업로드하는 데이터가 microsoft Graph를 통해 데이터에 대한 액세스 권한을 부여한 microsoft 이외의 서비스뿐만 아니라 Viva 및 Microsoft 365에서 처리될 수 있음을 이해했는지 확인합니다. 다음을 선택합니다.
업로드에 대한 세부 정보를 검토한 다음 유효성 검사 시작을 선택합니다.

조직 데이터는 Viva 및 Microsoft 365 서비스에서 사용하기 위한 요구 사항에 대해 유효성을 검사합니다. 유효성 검사에는 몇 시간이 걸립니다. 그러나 전체 데이터 업로드를 프로필 저장소에서 사용할 수 있는 데 최대 3일이 걸릴 수 있습니다. 관리 센터의 조직 데이터 페이지에서 유효성 검사 상태를 검사할 수 있습니다. 유효성 검사가 완료되면 Viva 및 Microsoft 365에서 데이터를 사용하고 관리한다는 메시지가 표시됩니다.

각 최종 사용자의 조직 데이터는 해당 최종 사용자의 사서함에 저장되며 Exchange Online 대한 Data Residency 설명된 대로 Exchange Online 대한 데이터 보존 규칙을 준수합니다.

4단계 - 데이터 업데이트 또는 기타 변경

전역 관리자만 Microsoft 365 사용자 프로필에 저장된 조직 데이터를 업데이트하거나 삭제할 수 있습니다.

최종 사용자의 조직 데이터를 업데이트하거나 삭제하려면 데이터를 업데이트하거나 삭제하려는 사용자만 포함하는 새 .csv 파일을 만들고 업로드합니다.

값을 업데이트하려면 업데이트하려는 모든 특성을 포함합니다. 변경하려는 특성에 대해 다른 값을 제공합니다. 특성을 포함하지만 값을 제공하지 않고 빈 문자열로 설정하지 않으면 Microsoft 365 사용자 프로필의 현재 값이 사용되며 값이 업데이트되지 않습니다. 새 업로드는 이전 데이터와 병합되며 해당 데이터를 덮어쓰지 않습니다.
값을 삭제하려면 두 개의 작은따옴표('')를 사용하여 특성 값을 빈 문자열로 설정합니다. ( Microsoft_Layer 특성 "-1"을 설정합니다. 사용자의 모든 데이터를 삭제하려면 모든 특성에 대해 빈 문자열 또는 정수 값을 입력합니다.

참고

Excel을 사용하여 .csv 파일을 편집하는 경우 두 개의 작은따옴표('')가 아닌 세 개의 작은따옴표('')를 사용합니다. Excel에서는 작은따옴표(')를 이스케이프 문자로 표시합니다.

다음을 통해 공유