일반적인 SPMT 오류 문제 해결

  • 아티클

이 문서에서는 SharePoint 마이그레이션 도구(SPMT)를 사용하는 경우 발생할 수 있는 일반적인 문제와 오류에 대해 설명합니다.

참고

SPMT 설치 문제에 대한 도움말은 다음을 참조하세요: SPMT 설치 문제 해결

일반 오류 메시지

메시지 실행할 작업
제공한 사이트에 연결할 수 없습니다. 목록이 존재하는지 또는 컴퓨터에서 원본 사이트와 대상 사이트에 액세스할 수 있는지 확인합니다.

사이트에 액세스할 수 있는 계정으로 SPMT에 로그인했는지 확인합니다.

입력한 URL이 올바르고 적절한 형식을 따르는지 확인합니다.
예: <스팸 스><팸>https://< 스팸><스팸>contoso.sharepoint.com/teams/SiteTitle<스팸><스팸>
유효하지 않은 원본 폴더 입력한 경로가 올바르고 적절한 형식

을 따르는지 확인 SPMT 사용자에게 폴더에 대한 읽기 권한이 있는지 확인합니다.
사이트를 생성하거나 업데이트할 수 없습니다 사이트를 만들 수 있는 권한이 있고 URL이 유효한

지 확인합니다. 사이트가 있는 경우 사이트 모음 관리자

인지 확인합니다. 그래도 실패하는 경우 사이트를 수동으로 만들고 마이그레이션 도구를 이 새로 만든 사이트로 가리킵니다.
파일 검색 실패: 폴더 이름이 유효하지 않음 OneDrive 및 SharePoint에서 잘못된 파일 이름 및 파일 형식을 참조하세요.
파일 검색 실패: 대상 경로가 너무 김 OneDrive 및 SharePoint에서 잘못된 파일 이름 및 파일 형식을 참조하세요.


파일 이름을 포함한 전체 경로는 OneDrive, OneDrive 및 SharePoint에 대해 400자 미만이어야 합니다.
파일 검색 오류: 디스크 공간이 부족하여 파일을 압압축할 수 없음 마이그레이션 작업 폴더에 사용할 수 있는 디스크 공간이 소스 파일 크기에 비해 너무 작습니다. 작업 폴더의 크기를 확대하고 다시 시도하세요.
패키징 실패: 파일을 열 수 없습니다 존재하지 않는 원본 때문에 패키징에 실패했습니다. 원본 루트 폴더에 액세스할 수 있는지 확인합니다.
중복된 작업이 이미 생성 되었습니다. 대량 마이그레이션을 수행하는 데 사용되는 CSV 파일에는 중복 항목이 있을 수 없습니다. 중복된 줄을 제거하고 다시 시도하세요.
상위 폴더가 마이그레이션되지 않음 부모 폴더가 마이그레이션되지 않았으므로 폴더 아래의 모든 항목을 마이그레이션하지 못했습니다. 상위 폴더를 확인하고 마이그레이션을 다시 시도하세요.
작업 #, 매개 변수 1. 원본 경로가 비어 있지 않아야 함 CSV 파일의 소스 경로 열에 값이 있는지 확인하세요.
작업 #, 매개 변수 4. 대상 URL이 잘못된 URL입니다. CSV 파일의 대상 URL 열에 값이 있고 유효한지 확인하세요.
작업 #, 매개 변수 5. 대상 목록을 비워 두면 안 됩니다. CSV 파일의 대상 목록 열에 값이 있는지 확인하세요.
이 콘텐츠를 OneDrive로 마이그레이션하려면 관리자 권한이 필요합니다. 콘텐츠를 마이그레이션하는 데 사용되는 계정에 대상 OneDrive에 대한 권한이 있는지 확인합니다.

SPMT 오류 코드

오류 코드 권장 작업
0x0201000D 목록이 존재하는지 또는 원본 사이트와 대상 사이트에서 액세스할 수 있는지 확인하세요.
0x02050008 로컬 저장소에 액세스할 수 없습니다. 마이그레이션을 다시 시작하세요.
0x02010023 원본 목록 템플릿은 지원되지 않습니다. 다른 방법을 시도해 보세요.
0x0201000C 자격 증명을 확인한 다음 사용자 이름과 암호를 다시 입력하세요.
0x02010017 사용자가 사이트 모음 관리자여야 합니다.
0x02060009 1 - URL이 이미 사용 중이거나 잘못된 URL이므로 사이트 모음을 만들 수 없습니다.
2 - URL에 잘못된 문자가 포함되어 있으므로 사이트 모음을 만들 수 없습니다.
3 - 사이트 모음을 만들거나 업데이트할 수 없습니다.
0x02060007 1 - URL이 이미 사용 중이거나 잘못된 URL이므로 사이트 모음을 만들 수 없습니다.
2 - URL에 잘못된 문자가 포함되어 있으므로 사이트 모음을 만들 수 없습니다.
0x02010018 1 - 자격 증명을 확인한 다음 다시 시도하세요.
2 - SharePoint에 액세스하는 도중 문제가 발생했습니다.   자격 증명을 확인하고 다시 시도하세요.
3 - SharePoint에 액세스하는 도중 문제가 발생했습니다. 자격 증명 및 네트워크 연결을 확인하고 다시 시도하세요.
4 - SharePoint에 액세스하는 도중 문제가 발생했습니다. 자격 증명 및 사이트 URL이 정확한지 확인하고 다시 시도하세요.
5 - SharePoint에 액세스하는 도중 문제가 발생했습니다. 자격 증명 및 URL 형식을 확인하세요. 다시 시도하세요.
6 - SharePoint에 액세스하는 도중 문제가 발생했습니다.   자격 증명을 확인하고 다시 시도하세요. 문제가 계속되면 지원 사례를 만듭니다.
7 - SharePoint에 액세스하는 도중 문제가 발생했습니다.   자격 증명을 확인하고 브라우저에서 사이트를 열어보세요.
0x0204000A 패키지 파일을 만들 수 없습니다. SPMT 작업 폴더 %appdata%\Microsoft\MigrationToolStorage의 모든 파일 및 폴더를 종료해야 합니다. 마이그레이션을 다시 시작하세요.
0x02030001 1 - 자격 증명을 확인하세요. 마이그레이션을 다시 시작하세요.
2 - 자격 증명을 확인하세요. 마이그레이션을 다시 시작하세요.
3 - 자격 증명 및 네트워크 연결을 확인하세요. 마이그레이션을 다시 시작하세요.
4 - 자격 증명 및 사이트 URL을 확인하세요. 마이그레이션을 다시 시작하세요.
5 - 자격 증명 및 URL 형식을 확인하세요. 마이그레이션을 다시 시작하세요.
6 - 자격 증명을 확인하고 마이그레이션을 다시 시작하세요. 메시지가 지속되면 지원 사례를 만듭니다.
7 - 자격 증명을 확인하고 브라우저에서 사이트를 열어보세요. 마이그레이션을 다시 시작하세요.
0x02010008 사용자 맵핑 파일의 경로 및 형식을 확인하고 이에 대한 액세스 권한이 있는지 확인하세요.
0x02050001 SPMT 작업 폴더 %appdata%\Microsoft\MigrationToolStorage의 모든 파일 및 폴더를 종료해야 합니다. 마이그레이션을 다시 시작하세요.
0x02010002 네트워크 상태를 확인하세요. 브라우저에서 원본 사이트에 액세스할 수 있다면 지원 사례를 생성하세요.
0x02010010 원본 목록과 대상 목록이 같은 템플릿에 있는지 확인하세요.
0x0204000D 마이그레이션을 진행하는 동안 SPMT 작업 폴더 %appdata%\Microsoft\MigrationToolStorage의 모든 파일 및 폴더를 종료해야 합니다. 마이그레이션을 다시 시작하세요.
0x02040012 로컬 컴퓨터의 임시 저장소가 너무 낮습니다. SPMT가 작업 폴더에서 패키지를 캐시합니다. 임시 저장소를 확장하고 다시 시도하세요.
0x02030003 고유한 사용 권한을 가진 항목이 너무 많습니다. 고유 권한의 수를 줄여 권한 목록을 단순화하세요. 마이그레이션을 다시 시도하세요.
0x02050001 로컬 저장소 파일이 손상되었습니다. 마이그레이션이 진행되는 동안 작업 폴더를 건드렸거나 수정했습니다. 마이그레이션을 다시 시도하세요.
0x02080001 업로드하는 동안 패키지 내의 파일이 변경 또는 삭제되었습니다. SPMT 작업 폴더 %appdata%\Microsoft\MigrationToolStorage의 모든 파일 및 폴더를 종료해야 합니다. 마이그레이션을 다시 시작하세요.
0x02010006 원본 SharePoint 사이트에 정의된 역할 정의가 없습니다. 원본 사이트에 액세스할 때 역할이 존재하는지 확인하세요.
0x02040009 디렉터리를 찾을 수 없으므로 패키지를 만들 수 없습니다. SPMT 작업 폴더 %appdata%\Microsoft\MigrationToolStorage의 모든 파일 및 폴더를 종료해야 합니다. 마이그레이션을 다시 시작하세요.
0x02010020 SPMT 설정에서 마이그레이션 버전 기록을 사용 중지 하거나 SPO에서 버전을 사용하세요.
0x0201000E 글로벌 설정으로 대상 경로에서 특수 문자를 필터링했는지 또는 경로에 지원되지 않는 문자가 있는지 확인하세요.
0x02010016 SharePoint Server 사용자를 찾을 수 없습니다. 사이트 모음 관리자인지 확인합니다.
0X0201000F 잘못된 사이트 URL. 사이트 URL이 유효한지 확인합니다. 브라우저를 통해 URL에 액세스 해보세요.
0x0207001 작업 폴더로의 액세스 권한이 없습니다. %appdata%\Microsoft\MigrationToolStorage에 액세스할 수 있는지 확인합니다.
0x01410010 목록 항목에 대한 종속성 누락 때문에 오류가 발생했습니다. 자세한 내용은 FailureSummaryReport.csv를 참조하세요. 종속성이 마이그레이션 범위에 포함되어 있는지 확인합니다.
0x01510001 패키지를 업로드하지 못했습니다. Azure 저장소를 사용자 지정한 경우, Azure 저장소에 액세스할 수 있는지 확인하고 대상 사이트에 액세스할 수 있는지 확인합니다. 마이그레이션을 다시 시도하세요.
0x01510001 작업을 서버에 업로드 하지 못했습니다. 마이그레이션 중에 파일 업로드에 실패했습니다.
0x02070009 여러 패키지를 업로드하지 못했습니다. 작업을 일시 중단하고 네트워크 연결을 확인합니다.
0x01710009 작업 종료 장애로 인해 오류가 발생했습니다; 패키지에서 일부 항목에 오류가 발생했습니다. 마이그레이션을 다시 시작합니다.
0x01710009 파일을 처리하는 서버에 대한 오류나 시간 초과: 패키지의 모든 항목이 마이그레이션되지 않았습니다.
0x01610001 Azure 컨테이너의 기한이 만료되었습니다. 마이그레이션 작업을 다시 시도하세요.
0x01710006 파일을 처리 하는 서버에 대한 오류나 시간 초과: 작업 심각한 오류
0x01710004 파일을 처리하는 서버에 대한 오류나 시간 초과 폴더 이름을 조회할 수 없습니다. 항목이 동일한 사이트 모음의 다른 목록 또는 사이트에 있을 수 있습니다. 또는 항목이 휴지통에 있습니다.
0x0131000D 목록 항목 버전을 모두 가져올 수 없습니다. 도구는 항목 버전을 가져오기 위한 요청을 보내지만 아무 것도 반환되지 않습니다. 이 오류는 다운로드 링크가 일반 파일과 .aspx 파일 간에 다를 때 발생할 수 있습니다. 이 사례는 4.x 버전에서 해결되었습니다.
0x0131000F 파일을 읽지 못했습니다. 파일이 체크 아웃되었습니다.
0x0111000A 파일 검사 실패: 파일 크기가 제한을 초과합니다. 현재 제한은 릴리스 정보: SPMT(SharePoint 마이그레이션 도구)를 참조하세요.
오류 이유 작업
이 탐색 노드에 잘못된 URL이 포함되어 있으므로, 이 URL에서 가리키는 개체를 찾을 수 없습니다. SharePoint는 탐색 노드를 만들기 전에 URL의 유효성을 검사합니다. URL이 SharePoint 개체를 나타내고 개체를 찾을 수 없는 경우 SharePoint는 이 오류로 노드 만들기 쿼리를 거부합니다. URL의 대상이 삭제되었거나, 이동되거나, 아직 마이그레이션되지 않았거나, 현재 작업에서 URL 매핑을 인식할 수 없는 이전 작업에서 마이그레이션된 경우 개체를 찾을 수 없습니다. 여러 작업 간에 동일한 URL 매핑을 사용합니다. 예:

작업 1: http:domain/new_path/site//domain/original_path/site -> http://






Task 2: http://. domain/new_path/site2domain/original_path/site2 -
>





다른 작업을 실행하여 이전에 마이그레이션되지 않은 개체를 가리키는 탐색 노드를 마이그레이션할 http:// 있습니다. 대상 사이트에서 노드를 수동으로 만들었습니다.
탐색 설정이 세밀하게 사용자 지정되어 있습니다. 현재 지원되지 않습니다. 전역 및 현재 사이트 탐색은 해당 값이 미리 정의된 템플릿과 일치할 경우에만 마이그레이션될 수 있습니다. 그렇지 않으면 값이 고도로 사용자 지정된 것으로 인식되며 마이그레이션되지 않습니다. 전역 및 현재 탐색을 변경하여 미리 정의 된 템플릿 중 하나를 사용합니다. 사이트 설정 -> 모양 및 느낌 -> 탐색을 참조하세요. 대상 사이트에서 설정을 수동으로 편집합니다.
대상 용어 저장소 ID를 가져올 수 없습니다. 웹 탐색 설정의 분류 공급자를 업데이트할 수 없습니다. 전역 및/또는 현재 사이트 탐색 설정이 "관리 탐색"으로 설정되었으므로 용어 저장소 스캐너가 대상 용어 저장소 ID를 가져올 수 없습니다. 관리되는 메타데이터 서비스가 제대로 구성되지 않은 경우 용어 저장소 스캐너가 대상 용어 저장소 ID를 가져오지 못합니다. 자세한 내용은 SPMT 관리되는 메타데이터 마이그레이션을 참조하세요.
웹 탐색 설정의 분류 공급자 용어 집합 ID가 유효하지 않습니다. 전역 또는 현재 사이트 탐색 설정이 "관리 탐색"으로 설정되면 용어 저장소 스캐너가 용어 집합 ID를 매핑할 수 없습니다. 원본 사이트의 설정이 유효하고 용어 집합이 성공적으로 마이그레이션되었는지 확인합니다.
웹 탐색 설정을 업데이트하려면 다음 권한이 필요합니다. 페이지를 추가하고 사용자 지정합니다. 마이그레이션에 사용되는 SharePoint 계정에 사이트 탐색 설정을 편집할 수 있는 권한이 없습니다. "페이지 추가 및 사용자 지정" 권한을 이 계정에 부여합니다.

분류 오류

오류 이유 작업
사용 권한 문제로 인해 용어 저장소 마이그레이션에 실패했습니다. 사용자는 용어 저장소 관리자가 아닙니다. SharePoint 관리 센터에서 클래식 기능을 선택한 다음, 용어 저장소에서 열기를 선택합니다. 마이그레이션할 용어 저장소를 선택하고 현재 사용자를 용어 저장소 관리자로 추가합니다.
작업 언어 부족으로 인해 용어 저장소를 마이그레이션하지 못했습니다. 원본 용어 저장소의 일부 작업 언어가 대상 용어 저장소에 없습니다. SharePoint 사이트 설정으로 이동 사이트 관리에서 용어 저장소 관리를 선택합니다. 업데이트할 용어 저장소를 선택하고, 원본 용어 저장소에 있는 모든 언어를 선택하여 대상 작업 언어 패널에 추가합니다.
기본 용어 저장소가 없으므로 용어 저장소 마이그레이션에 실패했습니다. SP 온-프레미스에 기본 사이트 모음 용어 저장소가 없습니다. SharePoint Server(온-프레미스) 중앙 관리로 이동하여 응용 프로그램 관리에서 서비스 응용 프로그램을 관리하고 관리 메타데이터 서비스 연결의 속성을 편집합니다. 이 서비스 응용 프로그램은 열 특정 용어 집합의 기본 저장 위치입니다를 선택합니다.
몇 개의 기본 용어 저장소가 있으므로 용어 저장소 마이그레이션에 실패했습니다. SP 온-프레미스에는 있는 몇 개의 기본 사이트 모음 용어 저장소가 있습니다. SharePoint OnPrem 중앙 관리로 이동하여 응용 프로그램 관리에서 서비스 응용 프로그램을 관리하고, 기본 용어 저장소로 한 개의 관리 메타데이터 서비스 연결을 선택합니다. 다른 관리 메타데이터 서비스 연결의 이 서비스 응용 프로그램은 열 관련 용어 집합의 기본 저장 위치입니다를 선택 취소합니다.
원본 용어가 없으므로 고정된 용어를 마이그레이션하지 못했습니다. 일부의 경우, 고정된 용어가 전역 용어 집합(이 관리 메타데이터 서비스 응용 프로그램에 연결하는 모든 사이트에 사용 가능)에 속하고 원본 용어는 로컬 용어 집합(이 사이트 모음의 사용자는 사용 가능)에 있습니다. SPMT는 먼저 전역 용어를 마이그레이션한 다음 로컬 용어를 마이그레이션합니다. 원본 용어가 로컬 집합에 있고 고정된 용어가 전역 집합에 있는 경우 SPMT가 고정된 전역 용어를 마이그레이션하기 전에 로컬 원본 용어가 마이그레이션되지 않습니다. 원본 로컬 용어가 이전 작업에서 마이그레이션되었으므로 고정된 전역 용어를 포함하도록 다시 마이그레이션합니다.

웹 파트 오류

오류 이유 작업
마이그레이션은 웹 파트를 지원하지 않음 현재 SPMT는 이 웹 파트를 지원하지 않습니다. 현재 지원되는 웹 파트인 SPMT 지원 웹 파트 목록을 확인합니다.
참조 목록 누락으로 인해 마이그레이션에 실패했습니다. 목록이 작업 목록에 추가되지 않았습니다. 웹 파트 및 참조 목록을 확인하여 마이그레이션 scope 있는지 확인합니다.
페이지가 사용자 지정되어 마이그레이션에 실패했습니다. SPMT는 현재 사용자 지정된 페이지 마이그레이션을 지원하지 않습니다. SharePoint Designer를 사용하여 해당 페이지의 서식 파일 페이지를 복원하고 마이그레이션을 다시 시작합니다.
페이지 마이그레이션에 실패하여 마이그레이션하지 못했습니다. 실패한 페이지 및 해당 페이지의 모든 웹 파트 마이그레이션. 실패한 페이지의 마이그레이션을 다시 시도하세요. 페이지가 성공하는 경우, 해당 페이지에 있는 모든 웹 파트가 성공적으로 마이그레이션됩니다.
안전하지 않은 웹 파트이고 서버 설정이 'NoScript'이므로 마이그레이션에 실패했습니다. 대상 SharePoint 사이트에 NoScript 설정이 켜져 있는 경우, 웹 파트에 JavaScript 스크립트 또는 기타 코드를 실행할 수 있는 기능이 있을 수 있으므로 웹 파트가 안전하지 않은 것으로 간주됩니다. 웹 파트를 마이그레이션하지 못하도록 차단됩니다. 이러한 웹 파트가 차단 해제되도록 대상 SharePoint 사이트에서 NoScript 설정을 끕니다. 중요: 해당 설정을 해제하면 사이트가 위험에 노출될 수 있습니다. 자세한 내용은 사용자 지정 스크립트 허용 또는 방지를 참조하세요.
잘못된 XML 정의로 인해 마이그레이션에 실패했습니다. XsltListView 웹 파트와 ListView 웹 파트에는 이러한 웹 파트를 마이그레이션하는 데 중요한 XML 정의가 포함되어 있습니다. 경우에 따라 업그레이드 문제나 서버 오류로 인해 XML 정의가 유효하지 않을 수 있습니다. SharePoint Server 원본 페이지에서 실패한 웹 파트를 삭제합니다. 다시 추가한 후 마이그레이션을 다시 시도하세요.
어셈블리 이름이 잘못되어 마이그레이션에 실패했습니다. 웹 파트의 어셈블리 이름은 SPMT에서 웹 파트를 마이그레이션하는 데 중요합니다. 웹 파트의 어셈블리를 SOAP 응답에서 구문 분석할 수 없는 경우 마이그레이션이 실패합니다. 이 웹 파트가 지원되는 "즉시 제공"(OOTB) 웹 파트인지 확인합니다. 지원되는 경우 버그를 제출하고 조사할 것입니다. 그러나 웹 파트가 타사 웹 파트인 경우 지원되지 않습니다.
웹 파트 연결 오류 때문에 마이그레이션이에 실패했습니다. 웹 파트가 마이그레이션에 실패한 다른 웹 파트에 연결되어 있으므로, 둘 다 실패하게 됩니다. 연결된 웹 파트가 마이그레이션에 성공했는지 확인합니다. 마이그레이션을 다시 시도하세요.
사용자를 매핑할 수 없으므로 마이그레이션에 실패했습니다. 사용자 필드가 웹 파트의 속성인 경우에는 SPMT가 원본 웹 파트(일반적으로 온-프레미스 사용자)에 있는 사용자를 대상 SharePoint 사이트의 사용자에 매핑합니다. 이 오류는 SPMT가 사용자에게 매핑할 수 없는 경우에 발생합니다. 모든 온-프레미스 사용자를 SharePoint에 동기화하는 데 Microsoft Entra ID가 사용되는지 확인합니다.