UsmtUtils 구문

  • 아티클

이 항목에서는 명령줄 인터페이스를 통해 사용자 상태 마이그레이션 도구(USMT) 5.0에서 사용할 수 있는 유틸리티의 구문에 대해 설명합니다. 이러한 유틸리티는 다음과 같은 기능을 합니다.

  • 마이그레이션을 위한 암호화 옵션을 쉽게 결정할 수 있도록 해줍니다.

  • 공유 잠금으로 인해 삭제할 수 없는 하드 링크 저장소를 제거하도록 도와줍니다.

  • 압축된 마이그레이션 저장소에 있는 카탈로그 파일이나 다른 파일이 손상되었는지 여부를 확인합니다.

  • 파일과 설정을 대상 컴퓨터로 마이그레이션할 때 압축된 마이그레이션 저장소에서 파일을 추출합니다.

이 항목의 내용

Usmtutils.exe

Verify 옵션

Extract 옵션

Usmtutils.exe

다음 표는 USMTutils.exe에 대한 명령줄 옵션을 보여줍니다. 다음 섹션에서는 /verify에 대한 추가 명령줄 옵션과 /extract 옵션을 제공합니다.

UsmtUtils.exe의 구문은 다음과 같습니다.

usmtutils [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

명령줄 옵션 설명

/ec

현재 시스템에서 지원되는 암호화 알고리즘(AlgID) 목록을 반환합니다. 원본 컴퓨터에서 ScanState 도구를 실행하기 전에 대상 컴퓨터에서 이 옵션을 사용하여 /encrypt 명령에 사용할 알고리즘을 결정할 수 있습니다.

/rd <storeDir>

컴퓨터에서 <storeDir> 인수로 지정한 디렉터리 경로를 제거합니다. 이 명령을 사용하면 공유 잠금으로 인해 명령 프롬프트에서 삭제할 수 없는 하드 링크 마이그레이션 저장소를 삭제할 수 있습니다. 마이그레이션 저장소가 지정된 드라이브의 여러 볼륨에 걸쳐 있는 경우 모든 볼륨에서 삭제됩니다.

예를 들어,

usmtutils /rd D:\MyHardLinkStore

/y

/rd 옵션과 함께 사용되어 삭제 적용 프롬프트를 재정의합니다. /y 옵션을 /rd 옵션과 함께 사용하면 USMT에서 디렉터리를 삭제하기 전에 삭제를 적용할지 묻는 메시지가 표시되지 않습니다.

/verify

압축된 마이그레이션 저장소를 그대로 유지할지 또는 압축된 마이그레이션 저장소에 손상된 파일 또는 카탈로그가 포함되어 있는지 여부에 대한 정보를 반환합니다.

/verify와 함께 사용할 구문 및 옵션은 Verify 옵션을 참조하세요.

/extract

압축된 USMT 마이그레이션 저장소에서 파일을 복구합니다.

/extract와 함께 사용할 구문 및 옵션은 Extract 옵션을 참조하세요.

Verify 옵션

압축된 마이그레이션 저장소를 그대로 유지할지 또는 압축된 마이그레이션 저장소에 손상된 파일 또는 카탈로그가 포함되어 있는지 여부를 결정하려면 /verify 옵션을 사용합니다. /verify 옵션을 사용하는 방법은 압축된 마이그레이션 저장소의 상태 확인을 참조하세요.

/verify의 구문은 다음과 같습니다.

usmtutils /verify[:<보고서 유형>] <파일 경로> [/l:<로그 파일>] [/v:VerbosityLevel] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<파일 이름>}]

명령줄 옵션 설명

<보고서 유형>

모든 파일에 대해 보고할지, 손상된 파일만 보고할지 또는 카탈로그의 상태를 보고할지 여부를 지정합니다.

  • Summary. 마이그레이션 저장소에서 손상된 파일 수와 그대로 유지되는 파일 수를 모두 반환합니다. 알고리즘을 지정하지 않으면 기본적으로 요약 보고서가 표시됩니다.

  • all. 압축된 마이그레이션 저장소에 있는 모든 파일의 탭으로 구분된 목록과 각 파일의 상태를 반환합니다. 각 줄에는 파일 이름이 표시되고 그 뒤에 탭 간격만큼 띄운 다음 파일의 상태에 따라 "CORRUPTED" 또는 "OK"가 표시됩니다. 마지막 항목은 저장소 "CATALOG"의 손상 상태를 보고합니다. 카탈로그 파일에는 마이그레이션 저장소에 있는 모든 파일에 대한 메타데이터가 포함되어 있습니다. LoadState 도구에서 마이그레이션 저장소를 열려면 올바른 카탈로그 파일이 있어야 합니다. 카탈로그 파일이 그대로 유지되고 LoadState에서 마이그레이션 저장소를 열 수 있으면 "OK"를 반환하고, 마이그레이션 저장소가 손상되었으며 "CORRUPTED"를 반환합니다.

  • failureonly. 압축된 마이그레이션 저장소에 있는 손상된 파일에 대해서만 탭으로 구분된 목록을 반환합니다.

  • Catalog. 카탈로그 파일의 상태만 반환합니다.

/l: <로그 파일 경로>

로그 파일의 위치와 이름을 지정합니다.

/v: <VerbosityLevel>

(Verbosity)

UsmtUtils 로그 파일에 자세한 정보를 표시합니다. 기본값은 0입니다.

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

 

수준 설명

0

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

1

자세한 정보를 표시하도록 설정합니다.

4

오류와 상태를 표시하도록 설정합니다.

5

자세한 정보와 상태를 표시하도록 설정합니다.

8

디버거에 대한 오류를 표시하도록 설정합니다.

9

디버거에 대한 자세한 정보를 표시하도록 설정합니다.

12

디버거에 대한 오류와 상태를 표시하도록 설정합니다.

13

자세한 정보, 상태 및 디버거를 표시하도록 설정합니다.

/decrypt: <AlgID> /key:<KeyString>

또는

/decrypt: <AlgID> /key:<“Key String”>

또는

/decrypt: <AlgID> /keyfile:<파일 이름>

ScanState 도구에서 /encrypt 옵션을 사용하여 마이그레이션 저장소를 만들었음을 지정합니다. 마이그레이션 저장소를 암호 해독하려면 /key 또는 /keyfile 옵션을 다음과 같이 지정합니다.

  • <AlgID>는 ScanState 명령줄에서 마이그레이션 저장소를 만드는 데 사용된 암호화 알고리즘을 지정합니다. 암호화 알고리즘을 지정하지 않으면 ScanState 및 UsmtUtils에서 기본적으로 3DES 알고리즘을 사용합니다.

    <AlgID>의 올바른 값은 AES_128, AES_192, AES_256, 3DES 또는 3DES_112입니다.

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

  • /keyfile: <파일 이름>은 암호화 키를 포함하는 텍스트(.txt) 파일의 위치와 이름을 지정합니다.

지원되는 암호화 알고리즘에 대한 자세한 내용은 마이그레이션 저장소 암호화를 참조하세요.

/verify 명령의 예:

  • usmtutils /verify D:\MyMigrationStore\store.mig

  • usmtutils /verify:catalog D:\MyMigrationStore\store.mig

  • usmtutils /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txt

  • usmtutils /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt

Extract 옵션

loadstate로 올바르게 복원되지 않는 경우에 압축된 USMT 마이그레이션 저장소에서 파일을 복구하려면 /extract 옵션을 사용합니다. /extract 옵션을 사용하는 방법은 압축된 USMT 마이그레이션 저장소에서 파일 추출을 참조하세요.

/extract의 구문은 다음과 같습니다.

/extract <파일 경로><대상 경로> [/i:<포함 패턴>] [/e: <제외 패턴>] [/l: <로그 파일>] [/v: 자세하게 수준>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <파일 이름>}] [/o]

명령줄 옵션 설명

<파일 경로>

USMT 마이그레이션 저장소의 경로입니다.

예를 들어,

D:\MyMigrationStore\USMT\store.mig

<대상 경로>

도구가 개별 파일을 저장하는 폴더의 경로입니다.

/i:<포함 패턴>

추출에 포함할 파일의 패턴을 지정합니다. 패턴을 여러 개 지정할 수 있습니다. 패턴을 쉼표 또는 세미콜론으로 구분합니다. 동일한 명령에서 /i: <포함 패턴> 옵션과 /e: <제외 패턴> 옵션을 함께 사용할 수 있습니다. 명령줄에서 include 패턴과 exclude 패턴을 모두 사용할 경우 include 패턴이 exclude 패턴보다 우선합니다.

/e:<제외 패턴>

추출에서 제외할 파일의 패턴을 지정합니다. 패턴을 여러 개 지정할 수 있습니다. 패턴을 쉼표 또는 세미콜론으로 구분합니다. 동일한 명령에서 /i: <포함 패턴> 옵션과 /e: <제외 패턴> 옵션을 함께 사용할 수 있습니다. 명령줄에서 포함 패턴과 제외 패턴을 모두 사용할 경우 포함 패턴이 제외 패턴보다 우선합니다.

/l:<로그 파일 경로>

로그 파일의 위치와 이름을 지정합니다.

/v: <자세하게 수준>

(Verbosity)

UsmtUtils 로그 파일에 자세한 정보를 표시합니다. 기본값은 0입니다.

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

 

수준 설명

0

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

1

자세한 정보를 표시하도록 설정합니다.

4

오류와 상태를 표시하도록 설정합니다.

5

자세한 정보와 상태를 표시하도록 설정합니다.

8

디버거에 대한 오류를 표시하도록 설정합니다.

9

디버거에 대한 자세한 정보를 표시하도록 설정합니다.

12

디버거에 대한 오류와 상태를 표시하도록 설정합니다.

13

자세한 정보, 상태 및 디버거를 표시하도록 설정합니다.

/decrypt: <AlgID> /key:<KeyString>

또는

/decrypt: <AlgID> /key:<“Key String”>

또는

/decrypt: <AlgID> /keyfile:<파일 이름>

ScanState 도구에서 /encrypt 옵션을 사용하여 마이그레이션 저장소를 만들었음을 지정합니다. 또한 마이그레이션 저장소를 암호 해독하려면 /key 또는 /keyfile 옵션을 다음과 같이 지정해야 합니다.

  • <AlgID>는 ScanState 명령줄에서 마이그레이션 저장소를 만드는 데 사용된 암호화 알고리즘을 지정합니다. 암호화 알고리즘을 지정하지 않으면 ScanState 및 UsmtUtils에서 기본적으로 3DES 알고리즘을 사용합니다.

    <AlgID>의 올바른 값은 AES_128, AES_192, AES_256, 3DES 또는 3DES_112입니다.

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

  • /keyfile:<FileName>은 암호화 키를 포함하는 텍스트(.txt) 파일을 지정합니다.

지원되는 암호화 알고리즘에 대한 자세한 내용은 마이그레이션 저장소 암호화를 참조하세요.

/o

기존 출력 파일을 덮어씁니다.

/extract 명령의 예:

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStore

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txt

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txt

  • usmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o

참고 항목

기타 리소스

USMT(User State Migration Tool) 명령줄 구문
반환 코드