LoadState 구문

이 항목에서는 LoadState 명령 구문과 옵션에 대해 설명합니다.

LoadState 명령을 실행하기 전에 다음을 참조하세요.

  • 모든 운영 체제 설정이 마이그레이션되도록 하려면 관리자 자격 증명이 있는 계정을 사용하여 관리자 모드에서 LoadState 명령을 실행하는 것이 좋습니다.

  • LoadState 명령을 실행하기 위한 소프트웨어 요구 사항에 대한 자세한 내용은 USMT 요구 사항을 참조하세요.

  • LoadState 명령을 실행한 후에는 로그오프해야 합니다. 일부 설정(예: 글꼴, 배경 무늬 및 화면 보호기 설정)은 다음에 사용자가 로그인할 때까지 적용되지 않습니다.

  • 별도로 지정되지 않은 한 명령줄에서 도구를 실행할 때는 각 옵션을 한 번만 사용할 수 있습니다.

  • LoadState는 도메인 프로필을 적용하기 위해 도메인 컨트롤러에 대한 액세스 권한이 필요하지 않습니다. 이 기능은 추가 구성 없이 사용할 수 있습니다. ScanState를 사용하여 사용자 프로필을 수집한 경우 원본 컴퓨터에는 도메인 컨트롤러에 대한 액세스 권한이 필요하지 않습니다. 그러나 대상 컴퓨터가 도메인에 가입하기 전에는 도메인 프로필에 액세스할 수 없습니다.

  • 호환되지 않는 명령줄 옵션 표에는 함께 사용할 수 있는 옵션 및 호환되지 않는 명령줄 옵션이 나열되어 있습니다.

이 섹션에서는 LoadState 명령을 사용할 때 사용 가능한 명령줄 옵션의 구문과 사용법에 대해 설명합니다. 옵션은 순서에 관계없이 지정할 수 있습니다. 옵션에 매개 변수가 포함된 경우 콜론 또는 공백으로 구분 기호를 지정할 수 있습니다.

LoadState 명령의 구문은 다음과 같습니다.

loadstate 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]

예를 들어 저장소 암호를 해독하고 파일과 설정을 Windows Vista 또는 Windows 7을 실행하는 컴퓨터로 마이그레이션하려면 명령줄에 다음을 입력합니다.

loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"

USMT는 마이그레이션된 데이터의 저장 방법과 위치를 지정할 수 있는 다음과 같은 옵션을 제공합니다.

 

명령줄 옵션 설명

StorePath

파일과 설정 데이터를 저장할 폴더를 나타냅니다. LoadState 명령을 사용할 때 StorePath를 지정할 수 있습니다. StorePath는 두 번 이상 지정할 수 없습니다.

/decrypt /key:KeyString

또는

/decrypt /key:"Key String"

또는

/decrypt /keyfile:[Path\]FileName

지정된 키를 사용하여 저장소의 암호를 해독합니다. 이 옵션을 사용할 때는 다음 방법 중 하나로 암호화 키를 지정해야 합니다.

  • /key: KeyString은 암호화 키를 지정합니다. KeyString에 공백이 있는 경우에는 인수를 따옴표로 묶어야 합니다.

  • /keyfile: FilePathAndName은 암호화 키가 들어 있는 텍스트 파일(.txt)을 지정합니다.

KeyString은 256자를 초과할 수 없습니다.

/key/keyfile 옵션은 동일한 명령줄에서 사용할 수 없습니다.

/decrypt/nocompress 옵션은 동일한 명령줄에서 사용할 수 없습니다.

Important중요
LoadState 명령줄 스크립트에 액세스할 수 있는 사용자는 누구나 암호화 키에 액세스할 수 있으므로 이 옵션을 사용할 때는 주의해야 합니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /decrypt /key:mykey

/decrypt: "encryption strength"

/decrypt 옵션은 마이그레이션 저장소 암호화에 대해 지정된 암호화 강도를 정의하는 명령줄 매개 변수를 허용합니다. 지원되는 암호화 알고리즘에 대한 자세한 내용은 마이그레이션 저장소 암호화를 참조하세요.

/hardlink

하드 링크 마이그레이션 저장소에서 사용자 상태 데이터를 복원할 수 있습니다. /hardlink 옵션과 함께 /nocompress 매개 변수를 지정해야 합니다.

/nocompress

저장소를 압축하지 않도록 지정합니다. 이 옵션은 테스트 환경에서만 사용해야 합니다. 실제 마이그레이션 중에는 압축된 저장소를 사용하는 것이 좋습니다. 이 옵션은 /decrypt 옵션과 함께 사용할 수 없습니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /nocompress

USMT 에서는 마이그레이션할 파일을 저장하기 위한 다음 옵션을 제공합니다.

 

명령줄 옵션 설명

/i:[Path\]FileName

(include)

마이그레이션할 상태를 정의하는 규칙이 포함된 .xml 파일을 지정합니다. 이 옵션을 여러 번 지정하여 모든 .xml 파일(MigApp.xml, MigSys.xml, MigDocs.xml 및 새로 만든 사용자 지정 .xml 파일)을 포함할 수 있습니다. Path는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않을 경우 FileName은 현재 디렉터리에 있어야 합니다.

지정할 파일에 대한 자세한 내용은 질문과 대답 항목의 "XML 파일" 섹션을 참조하세요.

/config:[Path\]FileName

LoadState 명령에서 사용해야 할 Config.xml 파일을 지정합니다. 명령줄에서 이 옵션을 두 번 이상 지정할 수 없습니다. Path는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않을 경우 FileName은 현재 디렉터리에 있어야 합니다.

다음 예에서는 Config.xml, MigDocs.xml 및 MigApp.xml 파일에 있는 규칙을 기반으로 하여 파일과 설정을 마이그레이션합니다.

loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:loadstate.log

/auto: "path to script files"

이 옵션을 사용하면 기본 .xml 파일의 위치를 지정한 다음 마이그레이션을 시작할 수 있습니다. 경로를 지정하지 않을 경우 USMT는 USMT 이진 파일이 있는 디렉터리를 사용합니다. /auto 옵션은 /i:MigDocs.xml/i:MigApp.xml /v:5 옵션을 사용하는 것과 동일한 효과를 갖습니다.

USMT는 마이그레이션 중에 발생한 문제를 분석하는 데 사용할 수 있는 여러 가지 명령줄 옵션을 제공합니다.

 

명령줄 옵션 설명

/l:[Path\]FileName

LoadState 로그의 위치와 이름을 지정합니다. StorePath에는 로그 파일을 저장할 수 없습니다. Path는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않는 경우 해당 로그가 현재 디렉터리에 만들어집니다. /v 옵션을 지정하여 출력 크기를 조정할 수 있습니다.

공유 네트워크 리소스에서 LoadState 명령을 실행하는 경우 이 옵션을 지정해야 합니다. 그렇지 않으면 USMT에서 "USMT was unable to create the log file(s)(로그 파일을 만들 수 없습니다.)"라는 오류가 발생합니다. 이 문제를 해결하려면 /l:load.log 옵션을 사용하세요.

/v: <VerbosityLevel>

(Verbosity)

LoadState 로그 파일에서 자세한 정보 출력을 사용하도록 설정합니다. 기본값은 0입니다.

VerbosityLevel을 다음 수준 중 하나로 설정할 수 있습니다.

 

수준 설명

0

기본 오류와 경고만 사용하도록 설정합니다.

1

자세한 정보 출력을 사용하도록 설정합니다.

4

오류 및 상태 출력을 사용하도록 설정합니다.

5

자세한 정보 및 상태 출력을 사용하도록 설정합니다.

8

디버거로의 오류 출력을 사용하도록 설정합니다.

9

디버거로의 자세한 정보 출력을 사용하도록 설정합니다.

12

디버거로의 오류 및 상태 출력을 사용하도록 설정합니다.

13

자세한 정보, 상태 및 디버거 출력을 사용하도록 설정합니다.

예:

loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml

/progress:[Path\]FileName

선택적인 진행률 로그를 만듭니다. StorePath에는 로그 파일을 저장할 수 없습니다. Path는 상대 경로 또는 전체 경로일 수 있습니다. Path 변수를 지정하지 않는 경우 FileName이 현재 디렉터리에 만들어집니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log

/c

이 옵션을 지정하면 치명적이지 않은 오류가 발생하는 경우 LoadState 명령이 계속 실행됩니다. 오류의 원인이 되는 파일 또는 설정은 진행률 로그에 기록됩니다. 예를 들어 컴퓨터에 맞지 않는 크기가 큰 파일이 있는 경우 LoadState 명령은 오류를 기록하고 마이그레이션을 계속합니다. /c 옵션을 지정하지 않으면 LoadState 명령은 첫 번째 오류가 발생할 때 종료됩니다. Config.xml 파일에서 새 <ErrorControl> 섹션을 사용하여 안전하게 무시할 수 있는 파일 또는 레지스트리 읽기/쓰기 오류와 마이그레이션의 실패 원인이 될 수 있는 오류를 지정할 수 있습니다. 이 경우 /c 명령줄 옵션은 사용자 환경에서 모든 I/O(입출력) 오류를 안전하게 건너뛸 수 있습니다. 또한 /genconfig 옵션은 이제 Config.xml 파일에서 오류 메시지 및 원하는 동작을 지정하여 사용하도록 설정하는 예제 <ErrorControl> 섹션을 생성합니다.

/r: <TimesToRetry>

(다시 시도)

서버에서 사용자 상태를 마이그레이션하는 동안 오류가 발생할 때 다시 시도 횟수를 지정합니다. 기본값은 3회입니다. 이 옵션은 네트워크 연결이 안정적이지 않은 환경에서 유용하게 사용할 수 있습니다.

사용자 상태를 복원하는 동안 /r 옵션은 네트워크 하드웨어 오류(예: 네트워크 케이블 결함 또는 연결 끊김) 또는 VPN(가상 사설망) 연결 실패로 인해 손실된 데이터는 복구하지 않습니다. 다시 시도 옵션은 연결 상태는 만족스럽지만 통신 대기 시간이 문제인 사용량이 많은 대규모 네트워크에 사용할 수 있습니다.

/w: <SecondsBeforeRetry>

(대기)

네트워크 파일 작업을 다시 시도하기 전 대기 시간(초)을 지정합니다. 기본값은 1초입니다.

/? 또는 /help

명령줄에 대한 도움말을 표시합니다.

기본적으로 모든 사용자가 마이그레이션됩니다. 포함하거나 제외할 사용자를 지정할 수 있는 유일한 방법은 다음 옵션을 사용하는 것입니다. 마이그레이션 .xml 파일이나 Config.xml 파일을 사용해서는 사용자를 제외할 수 없습니다. 자세한 내용은 사용자 확인을 참조하세요.

 

명령줄 옵션 설명

/all

컴퓨터에 있는 모든 사용자를 마이그레이션합니다.

/ue 또는 /uel 옵션을 사용하여 특별히 계정을 제외하지 않는 한 USMT는 컴퓨터에 있는 모든 사용자 계정을 마이그레이션합니다. 따라서 명령줄에서 이 옵션을 지정할 필요가 없습니다. 그러나 /all 옵션을 사용하도록 선택할 경우에는 /ui, /ue 또는 /uel 옵션을 사용할 수 없습니다.

/ui: DomainName\UserName

또는

/ui:"DomainName\User Name"

또는

/ui: ComputerName\LocalUserName

(사용자 포함)

지정된 사용자를 마이그레이션합니다. 기본적으로 마이그레이션에는 모든 사용자가 포함됩니다. 따라서 이 옵션은 /ue 옵션과 함께 사용할 때만 도움이 됩니다. /ui 옵션을 여러 번 지정할 수는 있지만 /all 옵션과 함께 /ui 옵션을 사용할 수는 없습니다. DomainNameUserName에는 별표(*) 와일드카드 문자를 포함할 수 있습니다. 공백이 포함된 사용자 이름을 지정할 때는 이름을 따옴표로 묶어야 합니다.

예:

  • Corporate 도메인의 User2만 포함하려면 다음과 같이 입력합니다.

    /ue:*\* /ui:corporate\user2

note참고
특정 사용자를 /ui 옵션을 사용하여 포함하도록 지정하고 동시에 /ue 또는 /uel 옵션을 사용하여 제외하도록 지정하면 이 사용자는 마이그레이션에 포함됩니다.

더 많은 예를 보려면 이 표의 /uel, /ue/ui 옵션에 대한 설명을 참조하세요.

/uel:<NumberOfDays>

또는

/uel:<YYYY/MM/DD>

또는

/uel:0

(마지막 로그온을 기반으로 하여 사용자 제외)

원본 컴퓨터에 있는 Ntuser.dat 파일의 마지막으로 수정한 날짜를 기반으로 하여 지정한 기간 내에 원본 컴퓨터에 로그온한 사용자만 마이그레이션합니다. /uel 옵션의 작동 원칙은 포함 규칙과 같습니다. 예를 들어 /uel:30 옵션은 ScanState 명령을 실행하는 날짜로부터 최근 30일 이내에 로그온했거나 사용자 계정이 수정된 사용자를 마이그레이션합니다. 일수를 지정하거나 날짜를 지정할 수 있습니다. 이 옵션은 /all 옵션과 함께 사용할 수 없습니다. USMT 에서는 로컬 컴퓨터에서 마지막 로그온 정보를 검색하므로 이 옵션을 실행하는 경우 컴퓨터를 네트워크에 연결할 필요가 없습니다. 또한 도메인 사용자가 다른 컴퓨터에 로그온한 경우 USMT에서 해당 로그온 인스턴스를 고려하지 않습니다.

note참고
/uel 옵션은 오프라인 마이그레이션에서는 사용할 수 없습니다.

예:

  • /uel:0ScanState 명령을 실행할 때 원본 컴퓨터에 로그온되어 있는 계정을 마이그레이션합니다.

  • /uel:90은 최근 90일 내에 로그온했거나 계정이 수정된 사용자를 마이그레이션합니다.

  • /uel:1은 최근 24시간 내에 계정이 수정된 사용자를 마이그레이션합니다.

  • /uel:2002/1/15는 2002년 1월 15일 이후에 로그온했거나 계정이 수정된 사용자를 마이그레이션합니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0

/ue:DomainName\UserName

또는

/ue:"DomainName\User Name"

또는

/ue:ComputerName\LocalUserName

(사용자 제외)

지정된 사용자를 마이그레이션에서 제외합니다. /ue 옵션을 여러 번 지정할 수는 있지만 /all 옵션과 함께 /ue 옵션을 사용할 수는 없습니다. DomainNameUserName에는 별표(*) 와일드카드 문자를 포함할 수 있습니다. 공백이 포함된 사용자 이름을 지정할 때는 이름을 따옴표로 묶어야 합니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /ue:contoso\user1

더 많은 예를 보려면 이 표의 /uel, /ue/ui 옵션에 대한 설명을 참조하세요.

/md: OldDomain:NewDomain

또는

/md: LocalComputerName:NewDomain

(도메인 이동)

사용자의 새 도메인을 지정합니다. 이 옵션을 사용하여 컴퓨터에 있는 사용자의 도메인을 변경하거나 로컬 사용자를 도메인 계정으로 마이그레이션할 수 있습니다. OldDomain에는 별표(*) 와일드카드 문자를 포함할 수 있습니다.

이 옵션을 두 번 이상 지정할 수 있습니다. 여러 도메인의 사용자를 단일 도메인으로 통합하려는 경우 /md 옵션을 여러 번 지정할 수 있습니다. 예를 들어 Corporate 도메인과 FarNorth 도메인의 사용자를 Fabrikam 도메인으로 통합하려면 /md:corporate:fabrikam/md:farnorth:fabrikam을 지정할 수 있습니다.

두 개의 /md 명령 간에 충돌이 있으면 첫 번째로 지정한 규칙이 적용됩니다. 예를 들어 /md:corporate:fabrikam/md:corporate:farnorth 명령을 지정할 경우 Corporate 사용자는 Fabrikam 도메인에 매핑됩니다.

note참고
원본 컴퓨터에 없는 OldDomain을 지정할 경우 LoadState 명령은 오류 또는 경고 없이 성공적으로 완료된 것처럼 보입니다. 그러나 이 경우 사용자는 NewDomain으로 이동되지 않고 원래 도메인에 그대로 유지됩니다. 예를 들어 "contoso"를 잘못 입력하여 "/md:contso:fabrikam"을 지정할 경우 사용자는 대상 컴퓨터의 contoso에 그대로 유지됩니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /md:contoso:fabrikam

/mu: OldDomain\OldUserName:[NewDomain\]NewUserName

또는

/mu: OldLocalUserName:NewDomain\NewUserName

지정한 사용자의 새 사용자 이름을 지정합니다. 저장소에 사용자가 두 명 이상 있는 경우 /mu 옵션을 여러 번 지정할 수 있습니다. 이 옵션에서는 와일드카드 문자를 사용할 수 없습니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /mu:contoso\user1:fabrikam\user1

/lac:[Password]

(로컬 계정 만들기)

사용자 계정이 로컬(비도메인) 계정이고 대상 컴퓨터에 없는 경우 USMT가 대상 컴퓨터에 계정을 만들지만 계정을 사용하지 못하게 설정합니다. 계정을 사용하도록 설정하려면 /lae 옵션도 함께 사용해야 합니다.

/lac 옵션을 지정하지 않으면 대상 컴퓨터에 없는 로컬 사용자 계정이 마이그레이션되지 않습니다.

Password는 새로 만든 계정의 암호입니다. 기본적으로 빈 암호가 사용됩니다.

Caution주의
암호는 일반 텍스트로 제공되어 LoadState 명령을 실행하는 컴퓨터에 액세스할 수 있는 사용자는 누구나 볼 수 있으므로 Password 변수를 사용할 때는 주의해야 합니다.

또한 컴퓨터에 여러 명의 사용자가 있는 경우 마이그레이션된 사용자가 모두 동일한 암호를 갖게 됩니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

자세한 내용은 사용자 계정 마이그레이션을 참조하세요.

/lae

(로컬 계정을 사용하도록 설정)

/lac 옵션을 사용하여 만든 계정을 사용하도록 설정합니다. /lac 옵션과 함께 이 옵션을 지정해야 합니다.

예:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /lac:password /lae

자세한 내용은 사용자 계정 마이그레이션을 참조하세요.

다음 예는 /ui/ue 옵션에 모두 적용됩니다. 지정한 사용자를 제외하지 않고 포함하려면 /ue 옵션을 /ui 옵션으로 바꿀 수 있습니다.

 

동작 명령

Corporate 도메인의 User One이라는 사용자를 제외합니다.

/ue:"corporate\user one"

Corporate 도메인의 User1이라는 사용자를 제외합니다.

/ue:corporate\user1

User1이라는 로컬 사용자를 제외합니다.

/ue:%computername%\user1

모든 도메인 사용자를 제외합니다.

/ue:Domain\*

모든 로컬 사용자를 제외합니다.

/ue:%computername%\*

모든 도메인에서 User1, User2 등의 사용자를 제외합니다.

/ue:*\user*

/uel, /ue/ui 옵션을 함께 사용하여 원하는 사용자만 마이그레이션할 수 있습니다.

/ui 옵션은 /ue 및 /uel 옵션보다 우선합니다. 특정 사용자를 /ui 옵션을 사용하여 포함하도록 지정하고 동시에 /ue 또는 /uel 옵션을 사용하여 제외하도록 지정하면 이 사용자는 마이그레이션에 포함됩니다. 예를 들어 /ui:contoso\* /ue:contoso\user1을 지정하면 /ui 옵션이 /ue 옵션보다 우선하므로 User1이 마이그레이션됩니다.

/uel 옵션은 /ue 옵션보다 우선합니다. 사용자가 /uel 옵션을 사용하여 설정한 기간 내에 로그온한 적이 있으면 /ue 옵션을 사용하여 이 사용자를 제외한 경우에도 사용자의 프로필이 마이그레이션됩니다. 예를 들어 /ue:contoso\user1 /uel:14를 지정할 경우 User1이 최근 14일 내에 컴퓨터에 로그온한 적이 있으면 마이그레이션됩니다.

 

동작 명령

Fabrikam 도메인의 User2만 포함하고 다른 사용자는 모두 제외합니다.

/ue:*\* /ui:fabrikam\user2

User1이라는 로컬 사용자만 포함하고 다른 사용자는 모두 제외합니다.

/ue:*\* /ui:user1

Contoso\User1을 제외하고 Contoso의 도메인 사용자만 포함합니다.

이 동작은 명령 하나만으로 완료할 수 없습니다. 대신 이 사용자 집합을 마이그레이션하려면 다음과 같이 지정해야 합니다.

  • ScanState 명령줄 도구를 사용하여 /ue:*\* /ui:contoso\*를 입력합니다.

  • LoadState 명령줄 도구를 사용하여 /ue:contoso\user1을 입력합니다.

로컬(비도메인) 사용자만 포함합니다.

/ue:*\* /ui:%computername%\*

다음 표에서는 LoadState 명령과 호환되지 않는 명령줄 옵션을 보여 줍니다. 특정 조합에 대한 표 항목이 비어 있으면 이 옵션은 호환되는 것으로 두 옵션을 함께 사용할 수 있습니다. X 기호는 두 옵션이 호환되지 않는다는 의미입니다. 예를 들어 /nocompress 옵션과 /encrypt 옵션은 함께 사용할 수 없습니다.

 

명령줄 옵션 /keyfile /nocompress /genconfig /all

/i

/v

/nocompress

해당 없음

X

/key

X

X

/decrypt

필수*

X

X

/keyfile

해당 없음

X

/l

/progress

X

/r

X

/w

X

/c

X

/p

X

해당 없음

/all

X

/ui

X

X

/ue

X

X

/uel

X

X

/genconfig

해당 없음

/config

X

StorePath

/md

/mu

/lae

/lac

note참고
/encrypt 옵션과 함께 /key 또는 /keyfile 옵션을 지정해야 합니다.

표시: