LoadState 구문
명령은 LoadState.exe USMT(사용자 상태 마이그레이션 도구)와 함께 사용하여 이전에 명령에 의해 ScanState.exe 캡처된 저장소를 대상 컴퓨터에 복원합니다. 이 문서에서는 LoadState.exe 명령 구문과 함께 사용할 수 있는 옵션에 대해 설명합니다.
시작하기 전에
명령을 실행 LoadState.exe 하기 전에 다음 항목을 확인합니다.
모든 운영 체제 설정이 마이그레이션되도록 하려면 관리자 자격 증명이 있는 계정에서 관리자 모드로 명령을 실행하는
LoadState.exe것이 좋습니다.명령을 실행
LoadState.exe하기 위한 소프트웨어 요구 사항에 대한 자세한 내용은 USMT 요구 사항을 참조하세요.명령을 실행한 후 로그아웃합니다
LoadState.exe. 예를 들어 글꼴, 배경 화면 및 화면 보호기 설정과 같은 일부 설정은 다음에 사용자가 로그인할 때까지 적용되지 않습니다.달리 지정하지 않는 한 명령줄에서 도구를 실행할 때 각 옵션을 한 번만 사용할 수 있습니다.
LoadState 는 도메인 프로필을 적용하기 위해 도메인 컨트롤러 액세스 권한이 필요하지 않습니다. 이 기능은 추가 구성 없이 사용할 수 있습니다. ScanState를 사용하여 사용자 프로필을 수집할 때 원본 컴퓨터에서 도메인 컨트롤러 액세스 권한을 가질 필요는 없습니다. 그러나 대상 컴퓨터가 도메인에 가입될 때까지 도메인 프로필에 액세스할 수 없습니다.
호환되지 않는 명령줄 옵션 테이블에는 함께 사용할 수 있는 옵션과 호환되지 않는 명령줄 옵션이 나열되어 있습니다.
구문
이 섹션에서는 명령을 사용할 때 사용할 수 있는 명령줄 옵션의 구문과 사용에 대해 LoadState.exe 설명합니다. 옵션은 순서대로 지정할 수 있습니다. 옵션에 매개 변수가 포함된 경우 콜론 또는 공간 구분 기호를 지정할 수 있습니다.
LoadState.exe 명령의 구문은 다음과 같습니다.
LoadState.exe StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName ] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|help]
예를 들어 저장소의 암호를 해독하고 파일 및 설정을 컴퓨터로 마이그레이션하려면 다음 명령을 입력합니다.
LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"
스토리지 옵션
USMT는 마이그레이션된 데이터가 저장되는 방법과 위치를 지정하는 데 사용할 수 있는 다음 옵션을 제공합니다.
| Command-Line 옵션 | 설명 |
|---|---|
| StorePath | 파일 및 설정 데이터가 저장되는 폴더를 나타냅니다. 명령을 사용할 때 StorePath를 LoadState.exe 지정해야 합니다. 둘 이상의 StorePath를 지정할 수 없습니다. |
| /decrypt /key:KeyString or /decrypt /key:"Key String" or /decrypt /keyfile:[Path]FileName |
지정된 키를 사용하여 저장소의 암호를 해독합니다. 이 옵션을 사용하면 암호화 키를 다음 방법 중 하나로 지정해야 합니다.
KeyString 은 256자를 초과할 수 없습니다. /key 및 /keyfile 옵션은 동일한 명령줄에서 사용할 수 없습니다./decrypt 및 /nocompress 옵션은 동일한 명령줄에서 사용할 수 없습니다.중요 또는 keyfile 옵션을 사용할 때는 주의해야 /key 합니다. 예를 들어 이러한 옵션을 사용하여 명령을 실행하는 LoadState.exe 스크립트에 액세스할 수 있는 모든 사용자는 암호화 키에 액세스할 수도 있습니다.예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /decrypt:"암호화 강도" | 옵션은 /decrypt 명령줄 매개 변수를 수락하여 마이그레이션 저장소 암호화에 지정된 암호화 강도를 정의합니다. 지원되는 암호화 알고리즘에 대한 자세한 내용은 마이그레이션 저장소 암호화를 참조하세요. |
| /hardlink | 하드 링크 마이그레이션 저장소에서 사용자 상태 데이터를 복원할 수 있습니다. 매개 변수는 /nocompress 옵션으로 /hardlink 지정해야 합니다. |
| /nocompress | 저장소가 압축되지 않도록 지정합니다. 이 옵션은 테스트 환경에서만 사용해야 합니다. Microsoft는 실제 마이그레이션 중에 압축된 저장소를 사용하는 것이 좋습니다. 이 옵션은 옵션과 함께 /decrypt 사용할 수 없습니다.예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
마이그레이션 규칙 옵션
USMT는 마이그레이션할 파일을 지정하는 다음 옵션을 제공합니다.
| Command-Line 옵션 | 설명 |
|---|---|
| /i:[Path]FileName | (포함) 마이그레이션할 데이터를 정의하는 규칙을 포함하는 .xml 파일을 지정합니다. 이 옵션은 모든 .xml 파일( MigApp.xml, MigSys.xml및 MigDocs.xml 생성된 사용자 지정 .xml 파일)을 포함하도록 여러 번 지정할 수 있습니다. 경로 는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않으면 FileName이 현재 디렉터리에 있어야 합니다.지정할 파일에 대한 자세한 내용은 질문과 대답 문서의 "XML 파일" 섹션 을 참조하세요 . |
| /config:[Path]FileName | 명령에서 Config.xml 사용해야 하는 LoadState.exe 파일을 지정합니다. 이 옵션은 명령줄에서 두 번 이상 지정할 수 없습니다. 경로 는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않으면 FileName이 현재 디렉터리에 있어야 합니다.이 예제에서는 , MigDocs.xml및 파일의 규칙에 Config.xml따라 파일 및 MigApp.xml 설정을 마이그레이션합니다.LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
| /auto:"스크립트 파일 경로" | 이 옵션을 사용하면 기본.xml파일의 위치를 지정할 수 있습니다. 경로가 지정되지 않은 경우 USMT는 USMT 이진 파일이 있는 디렉터리를 사용합니다. 옵션은 /auto 다음 옵션을 /i:MigDocs.xml/i:MigApp.xml /v:5사용하는 것과 동일한 효과를 봅니다. |
모니터링 옵션
USMT는 마이그레이션 중에 발생하는 문제를 분석하는 데 사용할 수 있는 몇 가지 명령줄 옵션을 제공합니다.
| Command-Line 옵션 | 설명 |
|---|---|
| /l:[Path]FileName | LoadState 로그의 위치와 이름을 지정합니다. 로그 파일은 StorePath에 저장할 수 없습니다. 경로 는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않으면 로그가 현재 디렉터리에 만들어집니다. /v 로그의 세부 정보를 조정하는 옵션을 지정할 수 있습니다.공유 네트워크 리소스 l 에서 명령을 실행하는 LoadState.exe 경우 옵션을 지정해야 합니다. 그렇지 않으면 오류가 발생하여 USMT가 실패합니다.USMT에서 로그 파일을 만들 수 없습니다. 이 문제를 해결하려면 공유 네트워크 리소스에서 실행할 LoadState.exe 때 옵션을 지정 /l 해야 합니다. |
/v:<VerbosityLevel> |
(세부 정보 표시) LoadState 로그 파일에서 자세한 출력을 사용하도록 설정합니다. 기본값은 0입니다. VerbosityLevel은 다음 수준 중 하나로 설정할 수 있습니다.
예시: LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml |
| /progress:[Path]FileName | 선택적 진행률 로그를 만듭니다. 로그 파일은 StorePath에 저장할 수 없습니다. 경로 는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않으면 FileName이 현재 디렉터리에 만들어집니다. 예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log |
| /C | 이 옵션을 지정 LoadState.exe 하면 치명적이 아닌 오류가 발생하더라도 명령이 계속 실행됩니다. 오류를 발생시키는 모든 파일 또는 설정은 진행률 로그에 기록됩니다. 예를 들어 컴퓨터에 LoadState.exe 맞지 않는 큰 파일이 있는 경우 명령은 오류를 기록하고 마이그레이션을 계속합니다. /c 옵션이 LoadState.exe 없으면 첫 번째 오류에서 명령이 종료됩니다. < 파일에서 Config.xmlErrorControl> 섹션을 사용하여 안전하게 무시할 수 있는 파일 또는 레지스트리 읽기/쓰기 오류를 지정하고 마이그레이션에 실패할 수 있습니다. 이 오류 컨트롤을 사용하면 명령줄 옵션을 사용하여 환경의 /c 모든 입력/출력(I/O) 오류를 안전하게 건너뛸 수 있습니다. 또한 /genconfig 이 옵션은 이제 파일에서 오류 메시지 및 원하는 동작을 지정하여 사용하도록 설정된 샘플 <ErrorControl> 섹션을 Config.xml 생성합니다. |
/r:<TimesToRetry> |
(다시 시도) 서버에서 사용자 상태를 마이그레이션하는 동안 오류가 발생할 때 다시 시도할 횟수를 지정합니다. 기본값은 세 번입니다. 이 옵션은 네트워크 연결이 신뢰할 수 없는 환경에서 유용합니다. 사용자 상태가 복원 /r 되는 경우 오류 또는 연결이 끊긴 네트워크 케이블과 같은 네트워크 하드웨어 오류 또는 VPN(가상 사설망) 연결 실패로 인해 손실된 데이터는 복구되지 않습니다. 재시도 옵션은 연결이 만족스럽지만 통신 대기 시간이 문제가 되는 대규모의 사용 중인 네트워크를 위한 것입니다. |
/w:<SecondsBeforeRetry> |
(대기) 네트워크 파일 작업을 다시 시도하기 전에 대기할 시간(초)을 지정합니다. 기본값은 1초입니다. |
| /? 또는 /help | 명령줄에 도움말을 표시합니다. |
사용자 옵션
기본적으로 모든 사용자는 마이그레이션됩니다. 포함 및 제외할 사용자를 지정하는 유일한 방법은 다음 옵션을 사용하는 것입니다. 마이그레이션 .xml 파일이나 파일을 사용하여 Config.xml 사용자를 제외할 수 없습니다. 자세한 내용은 사용자 식별을 참조하세요.
| Command-Line 옵션 | 설명 |
|---|---|
| /모든 | 컴퓨터의 모든 사용자를 마이그레이션합니다. USMT는 계정이 또는 /uel 옵션으로 특별히 제외되지 않는 한 컴퓨터의 /ue 모든 사용자 계정을 마이그레이션합니다. 따라서 명령줄에서 이 옵션을 지정할 필요가 없습니다. 그러나 옵션을 /ui사용하는 /all 경우 , /ue 또는 /uel 옵션도 사용할 수 없습니다. |
| /ui:DomainName UserName or /ui:"DomainName 사용자 이름" or /ui:ComputerName LocalUserName |
(사용자 포함) 지정된 사용자를 마이그레이션합니다. 기본적으로 모든 사용자는 마이그레이션에 포함됩니다. 따라서 이 옵션은 옵션과 함께 /ue 사용할 때만 유용합니다. 여러 /ui 옵션을 지정할 수 있지만 /ui 옵션과 함께 /all 사용할 수는 없습니다. DomainName 및 UserName 은 별표(*) 와일드카드 문자를 포함할 수 있습니다. 공백이 포함된 사용자 이름을 지정하는 경우 따옴표(")로 묶어야 합니다.예를 들어 회사 도메인의 User2 만 포함하려면 다음을 입력합니다. /ue:* /ui:corporate\user2참고 사용자가 옵션과 함께 /ui 포함하도록 지정되고 또는 /uel 옵션으로 /ue 제외되도록 지정된 경우 사용자는 마이그레이션에 포함됩니다.자세한 예제는 이 테이블의 /uel, /ue및 /ui 옵션에 대한 설명을 참조하세요. |
/uel:<NumberOfDays>or /uel: <YYYY/MM/DD>or /uel:0 |
(마지막 로그온에 따라 사용자 제외) 원본 컴퓨터에서 Ntuser.dat 파일의 마지막 수정 날짜를 기준으로 지정된 기간 내에 원본 컴퓨터에 로그온한 사용자만 마이그레이션합니다. 옵션은 /uel 포함 규칙의 역할을 합니다. 예를 들어 /uel:30 이 옵션은 명령이 실행된 날짜 ScanState.exe 로부터 지난 30일 이내에 로그온했거나 사용자 계정이 수정된 사용자를 마이그레이션합니다. 일 수를 지정하거나 날짜를 지정할 수 있습니다. 이 옵션은 옵션과 함께 /all 사용할 수 없습니다. USMT는 로컬 컴퓨터에서 마지막 로그인 정보를 검색하므로 이 옵션을 실행할 때 컴퓨터를 네트워크에 연결할 필요가 없습니다. 또한 도메인 사용자가 다른 컴퓨터에 로그인하는 경우 USMT는 해당 로그인 instance 고려하지 않습니다. 참고 이 /uel 옵션은 오프라인 마이그레이션에서 유효하지 않습니다.예제:
예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0 |
| /ue:DomainName\UserName or /ue"DomainName\User Name" or /ue:ComputerName\LocalUserName |
(사용자 제외) 지정된 사용자를 마이그레이션에서 제외합니다. 여러 /ue 옵션을 사용할 수 있지만 /ue 옵션과 함께 /all 사용할 수 없습니다. DomainName 및 UserName 은 별표(*) 와일드카드 문자를 포함할 수 있습니다. 공백이 포함된 사용자 이름을 지정하는 경우 따옴표(")로 묶어야 합니다.예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1자세한 예제는 이 테이블의 /uel, /ue및 /ui 옵션에 대한 설명을 참조하세요. |
| /md:OldDomain:NewDomain or /md:LocalComputerName:NewDomain |
(도메인 이동) 사용자의 새 도메인을 지정합니다. 이 옵션을 사용하여 컴퓨터의 사용자에 대한 도메인을 변경하거나 로컬 사용자를 도메인 계정으로 마이그레이션할 수 있습니다. OldDomain 에는 별표() 와일드카드 문자가 포함될 수 있습니다. 이 옵션은 두 번 이상 지정할 수 있습니다. 여러 도메인에 걸쳐 사용자를 단일 도메인에 통합하는 경우 여러 /md 옵션을 지정해야 할 수 있습니다. 예를 들어 회사 및 FarNorth 도메인의 사용자를 Fabrikam 도메인으로 통합하려면 및 /md:farnorth:fabrikam설정을 /md:corporate:fabrikam 지정합니다.두 /md 명령 간에 충돌이 있는 경우 지정된 첫 번째 규칙이 적용됩니다. 예를 들어 및 /md:corporate:farnorth 명령이 지정된 경우 /md:corporate:fabrikam 회사 사용자는 Fabrikam 도메인에 매핑됩니다. 참고 원본 컴퓨터에 존재하지 않는 도메인을 지정 LoadState.exe 하면 명령이 오류나 경고 없이 성공적으로 완료된 것처럼 보입니다. 그러나 이 경우 사용자는 NewDomain 으로 이동되지 않고 원래 도메인에 남아 있습니다. 예를 들어 contoso 의 철자가 틀렸고 대신 /md:contso:fabrikam 이 지정된 경우 사용자는 대상 컴퓨터의 contoso 에 남아 있습니다.예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /md:contoso:fabrikam |
| /mu:OldDomain OldUserName:[NewDomain]NewUserName or /mu:OldLocalUserName:NewDomain NewUserName |
(사용자 이동) 지정된 사용자의 새 사용자 이름을 지정합니다. 저장소에 둘 이상의 사용자가 포함된 경우 여러 /mu 옵션을 지정할 수 있습니다. 와일드카드 문자는 이 옵션과 함께 사용할 수 없습니다.예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1 |
| /lac:[Password] | (로컬 계정 만들기) 사용자 계정이 인 경우:
/lae 사용하도록 설정하려면 옵션도 사용해야 합니다./lac 옵션을 지정하지 않으면 대상 컴퓨터에 아직 없는 로컬 사용자 계정이 마이그레이션되지 않습니다.암호 는 새로 만든 계정의 암호입니다. 빈 암호는 기본적으로 사용됩니다. 주의 암호 변수는 주의해서 사용합니다. Password 변수는 일반 텍스트로 제공되며 명령을 실행하는 LoadState.exe 컴퓨터에 액세스할 수 있는 모든 사용자가 암호를 가져올 수 있습니다.또한 컴퓨터에 여러 사용자가 있는 경우 마이그레이션된 모든 사용자에게 동일한 암호가 있습니다. 예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore자세한 내용은 사용자 계정 마이그레이션을 참조하세요. |
/lae |
(로컬 계정 사용) 옵션을 사용하여 만든 /lac 계정을 사용하도록 설정합니다. 이 /lac 옵션을 사용하여 옵션을 지정해야 합니다.예시: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /lac:password /lae자세한 내용은 사용자 계정 마이그레이션을 참조하세요. |
/ui 및 /ue 옵션의 예
다음 예제는 /ui 및 /ue 옵션 모두에 적용됩니다. /ue 옵션은 지정된 사용자를 제외하는 대신 포함할 /ui 옵션으로 바꿀 수 있습니다.
| 동작 | 명령 |
|---|---|
| 회사 도메인에서 User One이라는 사용자를 제외합니다. | /ue:"corporate\user one" |
| 회사 도메인에서 User1이라는 사용자를 제외합니다. | /ue:corporate\user1 |
| User1이라는 로컬 사용자를 제외합니다. | /ue:%computername%\user1 |
| 모든 도메인 사용자를 제외합니다. | /ue:Domain |
| 모든 로컬 사용자를 제외합니다. | /ue:%computername% |
| User1, User2 등의 모든 도메인에서 사용자를 제외합니다. | /ue:\user |
옵션을 함께 사용
/uel및 /ue/ui 옵션을 함께 사용하여 마이그레이션해야 하는 사용자만 마이그레이션할 수 있습니다.
/ui 옵션은 /ue 및 /uel 옵션보다 우선합니다. 사용자가 옵션을 사용하여 /ui 포함되고 또는 /uel 옵션을 사용하여 /ue 제외되는 경우 사용자는 마이그레이션에 포함됩니다. 예를 들어 가 지정된 경우 /ui:contoso\* /ue:contoso\user1 옵션이 옵션보다 우선하기 때문에 /ui User1이 /ue 마이그레이션됩니다.
/uel 옵션은 /ue 옵션보다 우선합니다. 사용자가 옵션에 의해 /uel 설정된 지정된 기간 내에 로그온한 경우 해당 사용자의 프로필은 옵션을 사용하여 /ue 제외되더라도 마이그레이션됩니다. 예를 들어 가 지정된 경우 /ue:contoso\user1 /uel:14 지난 14일 이내에 컴퓨터에 로그온한 경우 User1이 마이그레이션됩니다.
| 동작 | 명령 |
|---|---|
| Fabrikam 도메인의 User2만 포함하고 다른 모든 사용자를 제외합니다. | /ue:* /ui:fabrikam\user2 |
| User1이라는 로컬 사용자만 포함하고 다른 모든 사용자를 제외합니다. | /ue:* /ui:user1 |
| Contoso\User1을 제외한 Contoso의 도메인 사용자만 포함합니다. | 이 동작은 단일 명령을 사용하여 완료할 수 없습니다. 대신 이 사용자 집합을 마이그레이션하려면 다음 옵션을 지정합니다.
|
| 로컬(비 도메인) 사용자만 포함합니다. | /ue: /ui:%computername%* |
호환되지 않는 명령줄 옵션
다음 표에서는 명령과 호환 LoadState.exe 되지 않는 명령줄 옵션을 나타냅니다. 특정 조합에 대한 테이블 항목에 가 있는 ✔️ 경우 옵션은 호환되며 함께 사용할 수 있습니다. 기호는 ❌ 옵션이 호환되지 않음을 의미합니다. 예를 들어 옵션과 /nocompress 함께 /encrypt 옵션을 사용할 수 없습니다.
| Command-Line 옵션 | /keyfile | /nocompress | /genconfig | /모든 |
|---|---|---|---|---|
| /나 | ✔️ | ✔️ | ✔️ | ✔️ |
| /V | ✔️ | ✔️ | ✔️ | ✔️ |
| /nocompress | ✔️ | 해당 없음 | ❌ | ✔️ |
| /키 | ❌ | ✔️ | ❌ | ✔️ |
| /해독 | 필수* | ❌ | ❌ | ✔️ |
| /keyfile | 해당 없음 | ✔️ | ❌ | ✔️ |
| /L | ✔️ | ✔️ | ✔️ | ✔️ |
| /진행률 | ✔️ | ✔️ | ❌ | ✔️ |
| /R | ✔️ | ✔️ | ❌ | ✔️ |
| /W | ✔️ | ✔️ | ❌ | ✔️ |
| /C | ✔️ | ✔️ | ❌ | ✔️ |
| /P | ✔️ | ✔️ | ❌ | 해당 없음 |
| /모든 | ✔️ | ✔️ | ❌ | ✔️ |
| /Ui | ✔️ | ✔️ | ❌ | ❌ |
| /Ue | ✔️ | ✔️ | ❌ | ❌ |
| /uel | ✔️ | ✔️ | ❌ | ❌ |
| /genconfig | ✔️ | ✔️ | 해당 없음 | ✔️ |
| /구성 | ✔️ | ✔️ | ❌ | ✔️ |
| StorePath | ✔️ | ✔️ | ✔️ | ✔️ |
| /메릴랜드 | ✔️ | ✔️ | ✔️ | ✔️ |
| /뮤 | ✔️ | ✔️ | ✔️ | ✔️ |
| /lae | ✔️ | ✔️ | ✔️ | ✔️ |
| /락 | ✔️ | ✔️ | ✔️ | ✔️ |
참고
옵션으로 /key 또는 /keyfile 옵션을 지정 /decrypt 해야 합니다.
관련 문서
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기