USMT(사용자 상태 마이그레이션 도구) 일반적인 문제

다음 섹션에서는 USMT 10.0 도구를 실행할 때 발생할 수 있는 일반적인 문제에 대해 설명합니다. USMT는 마이그레이션 프로세스 중에 발생한 모든 오류를 자세히 설명하는 로그 파일을 생성합니다. 이러한 로그를 사용하여 마이그레이션 실패 문제를 해결할 수 있습니다.

마이그레이션 문제를 식별하기 위한 일반 지침

마이그레이션 중에 문제 또는 오류 메시지가 발생하면 다음 일반 지침을 사용하여 문제의 원인을 확인할 수 있습니다.

  • ScanState, LoadState 및 UsmtUtils 로그를 검사하여 정확한 USMT 오류 메시지 및 Windows® API(애플리케이션 프로그래밍 인터페이스) 오류 메시지를 가져옵니다. USMT 반환 코드 및 오류 메시지에 대한 자세한 내용은 코드 반환을 참조하세요. 명령 프롬프트 창 net.exe helpmsg <error_number> 에 를 입력하여 나열된 Windows 시스템 오류 코드에 대한 자세한 정보를 얻을 수 있습니다. 여기서 <error_number> 오류 메시지에 의해 생성된 오류 코드 번호입니다. 시스템 오류 코드에 대한 자세한 내용은 시스템 오류 코드(0-499)를 참조하세요.

    대부분의 경우 ScanStateLoadState 로그는 USMT 마이그레이션이 실패하는 이유를 나타냅니다. 마이그레이션을 테스트할 때 옵션을 /v:5 사용하는 것이 좋습니다. 이 세부 정보 수준은 프로덕션 마이그레이션에서 조정할 수 있습니다. 그러나 세부 정보 수준을 줄이면 프로덕션 마이그레이션 중에 발생하는 오류를 진단하기가 더 어려워질 수 있습니다. 로그 파일 출력을 디버거로 이동하려면 5보다 높은 세부 정보 수준을 사용할 수 있습니다.

    참고

    옵션을 사용하여 ScanStateLoadState 도구를 실행하면 /v:5 자세한 로그 파일이 만들어집니다. 이 옵션을 사용하면 로그 파일이 커지지만 추가 세부 정보는 마이그레이션 오류가 발생한 위치를 확인하는 데 도움이 될 수 있습니다.

  • /Verify UsmtUtils 도구와 함께 옵션을 사용하여 압축된 마이그레이션 저장소의 파일이 손상되었는지 여부를 확인합니다. 자세한 내용은 압축된 마이그레이션 저장소의 조건 확인을 참조하세요.

  • /Extract UsmtUtils 도구와 함께 옵션을 사용하여 압축된 마이그레이션 저장소에서 파일을 추출합니다. 자세한 내용은 압축된 USMT 마이그레이션 저장소에서 파일 추출을 참조하세요.

  • 마이그레이션을 모니터링하는 옵션을 사용하여 /Progress 진행률 로그를 만듭니다.

  • 원본 및 대상 컴퓨터의 경우 운영 체제 정보 및 인터넷 Explorer 및 기타 관련 프로그램과 같은 애플리케이션 버전을 가져옵니다. 그런 다음 문제를 재현하는 데 필요한 정확한 단계를 확인합니다. 이 정보는 무엇이 잘못되어 있는지 이해하고 테스트 환경에서 문제를 재현하는 데 도움이 될 수 있습니다.

  • LoadState 도구를 실행한 후 로그아웃합니다. 글꼴, 데스크톱 배경 및 화면 보호기 설정과 같은 일부 설정은 다음에 최종 사용자가 로그온할 때까지 적용되지 않습니다.

  • ScanState 또는 LoadState 도구를 실행하기 전에 모든 애플리케이션 닫습니다. ScanState 또는 LoadState 프로세스 중에 일부 애플리케이션이 실행되는 경우 USMT는 일부 데이터를 마이그레이션하지 않을 수 있습니다. 예를 들어 Microsoft Outlook®이 열려 있는 경우 USMT는 PST 파일을 마이그레이션하지 않을 수 있습니다.

    참고

    옵션을 지정하지 않으면 파일 또는 설정을 마이그레이션할 수 없는 경우 USMT가 실패합니다 /c . 옵션을 지정 /c 하면 USMT에서 오류를 무시합니다. 그러나 마이그레이션하지 않은 사용 중인 파일이 발견되면 오류를 기록합니다.

사용자 계정 문제

다음 섹션에서는 일반적인 사용자 계정 문제에 대해 설명합니다. 섹션을 확장하여 권장 솔루션을 확인합니다.

대상 컴퓨터에서 로컬 계정을 만드는 데 문제가 있습니다.

해상도: 계정을 만들고 로컬 계정을 마이그레이션하는 방법에 대한 자세한 내용은 사용자 계정 마이그레이션을 참조하세요.

모든 사용자 계정이 대상 컴퓨터로 마이그레이션된 것은 아닙니다.

원인/해결 방법 이 문제의 가능한 원인은 두 가지가 있습니다.

Windows 7, Windows 8 또는 Windows 10 ScanState 및 LoadState 도구를 실행하는 경우 관리자 자격 증명이 있는 계정에서 관리자 모드로 실행하여 지정된 모든 사용자가 마이그레이션되도록 해야 합니다. 관리자 모드에서 실행하려면 다음을 수행합니다.

  1. 모든 프로그램>액세서리시작을> 선택합니다.

  2. 명령 프롬프트를 마우스 오른쪽 단추로 클릭합니다.

  3. 관리자 권한으로 실행을 선택합니다.

  4. LoadState.exe 또는 ScanState.exe 명령을 지정합니다.

관리자 모드에서 USMT를 실행하지 않으면 로그온된 사용자 프로필만 마이그레이션에 포함됩니다.

사용되지 않은 컴퓨터의 모든 사용자 계정은 마이그레이션되지 않습니다. 예를 들어 User1을 컴퓨터에 추가하지만 User1이 로그온하지 않는 경우 USMT는 User1 계정을 마이그레이션하지 않습니다.

제외한 사용자 계정이 대상 컴퓨터로 마이그레이션되었습니다.

원인: 지정한 명령에 충돌 ui/ue 옵션이 있을 수 있습니다. 옵션을 사용하여 /ui 사용자를 지정하고 /ue 또는 /uel 옵션을 동시에 지정하면 사용자가 마이그레이션에 포함됩니다. 예를 들어 를 지정 /ui:domain1\* /ue:domain1\user1하면 옵션이 우선하기 때문에 User1이 /ui 마이그레이션됩니다.

해상도: 및 옵션을 함께 사용하는 /ui 방법에 대한 자세한 내용은 ScanState 구문 문서의 예제를 참조하세요./ue

/uel 옵션을 사용하고 있지만 많은 계정이 여전히 마이그레이션에 포함되어 있습니다.

원인: 옵션은 /uel 사용자의 NTUser.dat 파일의 마지막으로 수정된 날짜에 따라 달라집니다. 이 마지막 수정 날짜가 사용자의 마지막 로그인 날짜와 일치하지 않을 수 있는 시나리오가 있습니다.

해상도: 이는 옵션의 제한 사항입니다 /uel . 옵션을 사용하여 이러한 사용자를 수동으로 /ue 제외해야 할 수 있습니다.

LoadState 도구는 오류를 반환 코드 71로 보고하고 마이그레이션 테스트 중에 사용자 프로필을 복원하지 못합니다.

원인: 마이그레이션 테스트 중에 테스트 컴퓨터에서 ScanState 도구를 실행한 다음 동일한 컴퓨터에서 LoadState 도구를 테스트하기 위해 사용자 프로필을 삭제하는 경우 레지스트리에 충돌하는 키가 있을 수 있습니다. net use 명령을 사용하여 사용자 프로필을 제거하면 해당 프로필과 연결된 폴더와 파일이 삭제되지만 레지스트리 키는 제거되지 않습니다.

해상도: 사용자 프로필을 삭제하려면 제어판 사용자 계정 항목을 사용합니다. 사용자 프로필의 불완전한 삭제를 수정하려면 다음을 수행합니다.

  1. 관리자 권한 명령 프롬프트에 regedit.exe 입력하여 레지스트리 편집기를 엽니다.

  2. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList(으)로 이동합니다.

    각 사용자 프로필은 아래의 시스템 식별자 키에 ProfileList저장됩니다.

  3. 제거하려는 사용자 프로필의 키를 삭제합니다.

마이그레이션 전에 암호화되지 않은 파일은 이제 LoadState 도구를 실행하는 데 사용되는 계정으로 암호화됩니다.

원인:ScanState 도구는 암호화된 파일 및 EFS(파일 시스템 암호화) 인증서를 마이그레이션하는 옵션을 사용하여 /EFS:copyraw 실행되었습니다. 암호화 특성은 마이그레이션된 폴더에 설정되었지만 마이그레이션 전에 해당 폴더의 파일 콘텐츠에서 특성이 제거되었습니다.

해상도: 암호화된 파일 및 EFS 인증서를 포함하는 마이그레이션에 ScanState 도구를 사용하기 전에 명령 프롬프트에서 암호 도구를 실행하여 파일 및 폴더의 암호화 설정을 검토하고 변경할 수 있습니다. 암호화되지 않은 파일이 포함된 폴더에서 암호화 특성을 제거하거나 암호화된 폴더 내의 모든 파일의 내용을 암호화해야 합니다.

이미 잘못 마이그레이션된 파일에서 암호화를 제거하려면 LoadState 도구를 실행하는 데 사용한 계정으로 컴퓨터에 로그인한 다음 영향을 받는 파일에서 암호화를 제거해야 합니다.

LoadState 도구는 로그 파일에서 오류를 반환 코드 71 및 Windows 오류 2202로 보고합니다.

원인: 로컬 사용자 프로필을 오프라인으로 마이그레이션하는 동안 컴퓨터 이름이 변경되었습니다.

해상도:LoadState 도구를 실행하여 사용자의 새 이름을 지정할 때 옵션을 사용할 /mu 수 있습니다. 예를 들면 다음과 같습니다.

LoadState.exe  /i:MigApp.xml /i:MigDocs.xml \\server\share\migration\mystore 
/progress:Progress.log /l:LoadState.log /mu:fareast\user1:farwest\user1

명령줄 문제

다음 섹션에서는 일반적인 명령줄 문제에 대해 설명합니다. 섹션을 확장하여 권장 솔루션을 확인합니다.

"사용 오류: 256자를 초과하는 명령줄 옵션을 사용하여 파일 경로를 지정할 수 없습니다." 오류 메시지가 표시됩니다.

원인: 경로 길이가 절대 경로에 따라 계산되기 때문에 긴 저장소 또는 파일 경로를 지정하지 않더라도 경우에 따라 이 오류 메시지가 표시될 수 있습니다. 예를 들어 C:\Program Files\USMT40에서 명령을 실행 **ScanState**.exe /o store 하면 C:\Program Files\USMT40의 각 문자가 경로의 길이를 가져오기 위해 "store"의 길이에 추가됩니다.

해상도: 총 경로 길이가 256자를 초과하지 않는지 확인합니다. 총 경로 길이에는 저장소 경로와 현재 디렉터리가 포함됩니다.

"USMT에서 로그 파일을 만들 수 없습니다. 로그 디렉터리에 대한 쓰기 액세스 권한이 있는지 확인합니다."

원인: 공유 네트워크 리소스에서 ScanState 또는 LoadState 도구를 실행하는 경우 를 지정 /l하지 않으면 이 오류 메시지가 표시됩니다.

해상도: 이 시나리오에서 이 문제를 해결하려면 또는 /l:LoadState.log 옵션을 지정 /l:ScanState.log 합니다.

XML 파일 문제

다음 섹션에서는 일반적인 XML 파일 문제에 대해 설명합니다. 섹션을 확장하여 권장 솔루션을 확인합니다.

Config.xml 파일을 만드는 옵션을 사용 /genconfig 했지만 MigApp.xml 몇 개의 애플리케이션과 구성 요소만 표시됩니다. Config.xml 동일한 애플리케이션을 모두 포함하지 않는 이유는 무엇인가요?

원인:Config.xml.xml 파일 모두에 있고 옵션을 실행할 /genconfig 때 컴퓨터에 설치된 운영 체제 구성 요소, 애플리케이션 및 사용자 문서 섹션만 포함합니다. 그렇지 않으면 이러한 애플리케이션 및 구성 요소가 Config.xml 파일에 표시되지 않습니다.

해상도: 옵션을 실행하기 전에 컴퓨터에 원하는 모든 애플리케이션을 설치합니다 /genconfig . 그런 다음 모든 .xml 파일로ScanState.exe실행합니다. 예를 들어 다음 명령을 실행합니다.

ScanState.exe /genconfig:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:ScanState.log

작성한 사용자 지정 .xml 파일에 문제가 있으며 구문이 올바른지 확인할 수 없습니다.

해상도: XML 스키마 파일 MigXML.xsd 를 XML 제작 도구에 로드할 수 있습니다. MigXML.xsd 는 USMT에 포함되어 있습니다. 예제는 Visual Studio 개발 센터를 참조하세요. 그런 다음, 작성 도구에 .xml 파일을 로드하여 구문 오류가 있는지 확인합니다. XML 요소 사용에 대한 자세한 내용은 USMT XML 참조를 참조하세요.

MigXML 도우미 함수를 사용하고 있지만 마이그레이션이 예상대로 작동하지 않습니다. 이 문제를 해결할 어떻게 할까요? 있나요?

원인: 일반적으로 이 문제는 도우미 함수에 사용되는 잘못된 구문으로 인해 발생합니다. 성공 반환 코드가 표시되지만 마이그레이션하려는 파일이 수집되거나 적용되지 않았거나 예상대로 수집되거나 적용되지 않았습니다.

해상도: 로그 파일에서 관련 경고를 찾을 수 있도록 ScanState 또는 LoadState 로그에서 MigXML 도우미 함수가 포함된 구성 요소 이름 또는 MigXML 도우미 함수 제목을 검색해야 합니다.

마이그레이션 문제

다음 섹션에서는 일반적인 마이그레이션 문제에 대해 설명합니다. 섹션을 확장하여 권장 솔루션을 확인합니다.

제외하도록 지정한 파일은 여전히 마이그레이션 중입니다.

원인: 파일을 포함하는 다른 규칙이 있을 수 있습니다. 더 구체적인 규칙 또는 충돌하는 규칙이 있는 경우 파일이 마이그레이션에 포함됩니다.

해상도: 자세한 내용은 충돌 및 우선 순위 및로그 파일의 진단 로그 섹션을 참조하세요.

폴더를 대상 컴퓨터의 특정 위치로 이동하는 규칙을 지정했지만 올바르게 마이그레이션되지 않았습니다.

원인: XML 구문에 오류가 있을 수 있습니다.

해상도: USMT XML 스키마(MigXML.xsd)를 사용하여 마이그레이션 .xml 파일을 작성하고 유효성을 검사할 수 있습니다. 또한 다음 문서에서 XML 예제를 참조하세요.

충돌 및 우선 순위

파일 및 설정 제외

파일 및 설정 다시 라우팅

파일 및 설정 포함

사용자 지정 XML 예제

LoadState가 완료되면 대상 컴퓨터에 새 데스크톱 배경이 표시되지 않습니다.

이 문제의 일반적인 원인은 세 가지입니다.

원인: 글꼴, 데스크톱 배경 및 화면 보호기 설정과 같은 일부 설정은 대상 컴퓨터가 다시 시작될 때까지 LoadState 에서 적용되지 않습니다.

해상도: 이 문제를 해결하려면 로그아웃한 다음 다시 로그온하여 마이그레이션된 데스크톱 배경을 확인합니다.

마이그레이션에 MigApp.xml 포함했지만 일부 PST 파일은 마이그레이션되지 않습니다.

원인:MigApp.xml 파일은 Outlook 프로필에 연결된 PST 파일만 마이그레이션합니다.

해상도: Outlook 프로필에 연결되지 않은 PST 파일을 마이그레이션하려면 이러한 파일을 캡처하는 별도의 마이그레이션 규칙을 만들어야 합니다.

USMT는 시작 레이아웃을 마이그레이션하지 않습니다.

설명: USMT를 사용하여 한 Windows 10 설치에서 다른 하드웨어에 Windows 10 설치로 프로필을 마이그레이션합니다. 마이그레이션 후 사용자는 새 디바이스에 로그인하고 이전에 구성한 시작 메뉴 레이아웃이 없습니다.

원인: Windows 10 버전 1607 이상을 사용하는 시작 메뉴의 코드 변경은 이 USMT 함수와 호환되지 않습니다.

해상도: 다음 해결 방법을 사용할 수 있습니다.

  1. 사용자가 로그인하면 다음 Windows PowerShell 명령을 사용하여 시작 레이아웃을 백업합니다. 원하는 경우 다른 경로를 지정할 수 있습니다.

    Export-StartLayout -Path "C:\Layout\user1.xml"
    
  2. USMT를 사용하여 사용자 프로필을 마이그레이션합니다.

  3. 사용자가 새 디바이스에 로그인하기 전에 다음 Windows PowerShell 명령을 사용하여 시작 레이아웃을 가져옵니다.

    Import-StartLayout -LayoutPath "C:\Layout\user1.xml" -MountPath %systemdrive%
    

이 해결 방법은 기본 사용자의 시작 레이아웃을 변경합니다. 이 해결 방법은 대량 마이그레이션 또는 다중 사용자 디바이스로 확장되지 않지만 일부 시나리오의 차단을 해제할 수 있습니다. 다른 사용자가 디바이스에 로그온하는 경우 기본 사용자 프로필에서 layoutmodification.xml 삭제해야 합니다. 그렇지 않으면 해당 디바이스에 로그온하는 모든 사용자가 가져온 시작 레이아웃을 사용합니다.

오프라인 마이그레이션 문제

다음 섹션에서는 일반적인 오프라인 마이그레이션 문제에 대해 설명합니다. 섹션을 확장하여 권장 솔루션을 확인합니다.

일부 시스템 설정은 오프라인 마이그레이션에서 마이그레이션되지 않습니다.

원인: 데스크톱 배경 및 네트워크 프린터와 같은 일부 시스템 설정은 오프라인 마이그레이션에서 지원되지 않습니다. 자세한 내용은 USMT 마이그레이션을 참조하세요.

해상도: 오프라인 마이그레이션에서는 이러한 시스템 설정을 수동으로 복원해야 합니다.

반환 코드 26으로 ScanState 도구가 실패함

원인: 반환 코드 26의 일반적인 원인은 임시 프로필이 원본 컴퓨터에서 활성화되어 있기 위한 것입니다. 이 프로필은 c:\users\temp에 매핑됩니다. ScanState 로그에는 사용자 프로필 중복 SID 오류가 포함된 MigStartupOfflineCaught 예외가 표시됩니다.

해상도: 컴퓨터를 다시 부팅하여 임시 프로필을 제거하거나 MIG_FAIL_ON_PROFILE_ERROR=0 을 설정하여 오류를 건너뛰고 임시 프로필을 제외할 수 있습니다.

사용자 프로필 마이그레이션에 대한 포함 및 제외 규칙이 온라인과 동일한 오프라인으로 작동하지 않음

원인: 오프라인 상태인 경우 DNS 서버를 쿼리하여 사용자 이름 및 SID 매핑을 resolve 수 없습니다.

해상도:ScanState 도구를 실행할 때 SID(보안 식별자)를 사용하여 사용자를 포함합니다. 예를 들면

ScanState.exe /ui:S1-5-21-124525095-708259637-1543119021*

SID 끝에 있는 야생 카드(*)도 SID_Classes 키를 마이그레이션합니다.

일반 사용자 또는 그룹을 식별하는 SID에 대한 패턴을 사용할 수도 있습니다. 예를 들어 옵션을 사용하여 /ue:*-500 로컬 관리자 계정을 제외할 수 있습니다. Windows SID에 대한 자세한 내용은 보안 식별자를 참조하세요.

64비트 시스템에서 ScanState 도구를 실행한 후 디스크를 초기화하기 위한 스크립트가 실패함

원인:ScanState 도구 실행을 완료한 후에는 HKLM 레지스트리 하이브가 언로드되지 않습니다.

해상도:ScanState 도구 실행이 완료된 후 명령 프롬프트에서 컴퓨터를 다시 부팅하거나 레지스트리 하이브를 언로드합니다. 예를 들어 명령 프롬프트에서 다음을 입력합니다.

reg.exe unload hklm\$dest$software

다음 섹션에서는 일반적인 하드 링크 마이그레이션 문제에 대해 설명합니다. 섹션을 확장하여 권장 솔루션을 확인합니다.

EFS 파일이 새 파티션으로 복원되지 않음

원인: EFS 파일은 하드 링크가 있는 새 파티션으로 이동할 수 없습니다. /efs:hardlink 명령줄 옵션은 동일한 파티션에서 마이그레이션된 파일에만 적용됩니다.

해상도:/efs:copyraw 명령줄 옵션을 사용하여 하드 링크를 만드는 대신 마이그레이션 중에 EFS 파일을 복사하거나 하드 링크 저장소에서 EFS 파일을 수동으로 복사합니다.

원인: 마이그레이션 저장소에는 잠긴 파일에 대한 하드 링크가 포함되어 있습니다.

해상도: UsmtUtils 도구를 사용하여 저장소를 삭제하거나 저장소 이름을 변경합니다. 예를 들어 명령 프롬프트에서 다음을 입력합니다.

UsmtUtils.exe /rd <storedir>

또한 컴퓨터를 다시 부팅해야 합니다.

데이터 수집

Microsoft 지원의 지원이 필요한 경우 배포 관련 문제에 TSS를 사용하여 정보 수집에 설명된 단계에 따라 정보를 수집하는 것이 좋습니다.

USMT(사용자 상태 마이그레이션 도구) 문제 해결

자주 묻는 질문

반환 코드

UsmtUtils 구문