다음을 통해 공유

UsmtUtils 구문

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

  • 마이그레이션에 대한 암호화 옵션을 결정하는 기능을 개선합니다.

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

  • 압축된 마이그레이션 저장소의 카탈로그 파일 또는 다른 파일이 손상되었는지 확인합니다.

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

UsmtUtils.exe

다음 표에서는 에 대한 명령줄 옵션을 나열합니다 UsmtUtils.exe. 다음 섹션에서는 및 /extract 옵션에 대한 /verify 추가 명령줄 옵션을 제공합니다.

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

UsmtUtils.exe [/ec | /rd <storeDir> | /verify <filepath> [options] | /extract <filepath><destinationPath> [options]]

명령줄 옵션 설명
/Ec 현재 시스템에서 지원되는 AlgID(암호화 알고리즘) 목록을 반환합니다. 이 옵션은 원본 컴퓨터에서 ScanState 도구를 실행하기 전에 명령과 함께 사용할 알고리즘을 /encrypt 결정하기 위해 대상 컴퓨터에서 사용할 수 있습니다.
/rd<storeDir> 컴퓨터의 storeDir 인수에< 지정된 디렉터리> 경로를 제거합니다. 이 명령은 공유 잠금으로 인해 명령 프롬프트에서 삭제할 수 없는 하드 링크 마이그레이션 저장소를 삭제하는 데 사용할 수 있습니다. 마이그레이션 저장소가 지정된 드라이브의 여러 볼륨에 걸쳐 있는 경우 마이그레이션 저장소는 이러한 모든 볼륨에서 삭제됩니다.

예시:
UsmtUtils.exe /rd D:\MyHardLinkStore
/Y 옵션과 함께 사용할 때 삭제를 수락하라는 프롬프트를 재정의 /rd 합니다. /y 옵션과 함께 /rd 옵션을 사용하면 USMT에서 디렉터리를 삭제하기 전에 삭제를 수락하라는 프롬프트가 표시되지 않습니다.
/확인 압축된 마이그레이션 저장소가 손상되었는지 또는 손상된 파일 또는 손상된 카탈로그가 포함되어 있는지 여부에 대한 정보를 반환합니다.

에 사용할 /verify구문 및 옵션에 대한 확인 옵션을 참조하세요.
/추출 압축된 USMT 마이그레이션 저장소에서 파일을 복구합니다.

구문에 대한 추출 옵션 및 와 함께 /extract사용할 옵션을 참조하세요.

확인 옵션

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

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

UsmtUtils.exe /verify[:<reportType>] <filePath> [/l:<logfile>] [/v:VerbosityLevel] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<filename>}]

명령줄 옵션 설명
<reportType> 모든 파일, 손상된 파일만 보고할지 또는 카탈로그의 상태 보고할지를 지정합니다.
  • 요약. 손상되지 않은 파일 수와 마이그레이션 저장소에서 손상된 파일 수를 모두 반환합니다. 알고리즘을 지정하지 않으면 요약 보고서가 기본값으로 표시됩니다.
  • all. 압축된 마이그레이션 저장소에 있는 모든 파일의 탭으로 구분된 목록과 각 파일에 대한 상태 반환합니다. 각 줄에는 파일 이름 뒤에 탭 간격이 있고 파일의 상태 따라 손상되었거나 확인됩니다. 마지막 항목은 저장소 카탈로그의 손상 상태 보고합니다. 카탈로그 파일에는 마이그레이션 저장소의 모든 파일에 대한 메타데이터가 포함됩니다. 마이그레이션 저장소를 열려면 LoadState 도구에 유효한 카탈로그 파일이 필요합니다. 카탈로그 파일이 손상되지 않고 LoadState 가 마이그레이션 저장소를 열 수 있고 마이그레이션 저장소가 손상된 경우 "손상됨"이면 "확인"을 반환합니다.
  • 실패합니다. 압축된 마이그레이션 저장소에서 손상된 파일의 탭으로 구분된 목록을 반환합니다.
  • 카탈로그. 카탈로그 파일의 상태만 반환합니다.
/L:
<Logfilepath>		 로그 파일의 위치와 이름을 지정합니다.
/v:<VerbosityLevel> (세부 정보 표시)

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

VerbosityLevel은 다음 수준 중 하나로 설정할 수 있습니다.
  • 0 - 기본 오류 및 경고만 사용하도록 설정됩니다.
  • 1 - 자세한 출력을 사용하도록 설정합니다.
  • 4 - 오류 및 상태 출력을 사용하도록 설정합니다.
  • 5 - 자세한 정보 표시 및 상태 출력을 사용하도록 설정합니다.
  • 8 - 디버거에 대한 오류 출력을 사용하도록 설정합니다.
  • 9 - 디버거에 자세한 출력을 사용하도록 설정합니다.
  • 12 - 디버거에 대한 오류 및 상태 출력을 사용하도록 설정합니다.
  • 13 - 자세한 정보 표시, 상태 및 디버거 출력을 사용하도록 설정합니다.
/decrypt<AlgID>/:<KeyString>
or
/decrypt<AlgID>/:<"Key String">
or
/decrypt:<AlgID>/keyfile:<FileName>		 옵션을 사용하여 ScanState 도구를 사용하여 마이그레이션 저장소를 만들도록 지정 /encrypt 합니다. 마이그레이션 저장소의 암호를 해독하려면 다음과 같이 또는 /keyfile 옵션을 지정 /key 합니다.
  • <AlgID> 는 명령줄에서 마이그레이션 저장소를 만드는 데 사용된 암호화 알고리즘을 ScanState.exe 지정합니다. 알고리즘이 지정되지 않은 경우 ScanState 및 UsmtUtils 는 3DES 알고리즘을 기본값으로 사용합니다.
    <AlgID> 유효한 값은 AES_128, , AES_192AES_256, 3DES또는 3DES_112입니다.
  • /key:<KeyString> 은 암호화 키를 지정합니다. KeyString>에 공백이 있는< 경우 인수는 따옴표로 묶어야 합니다.
  • /keyfile: <FileName> 은 암호화 키를 포함하는 텍스트(.txt) 파일의 위치와 이름을 지정합니다.

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

명령의 /verify 몇 가지 예:

  • UsmtUtils.exe /verify D:\MyMigrationStore\store.mig

  • UsmtUtils.exe /verify:catalog D:\MyMigrationStore\store.mig

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

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

추출 옵션

/extractLoadState를 사용하여 정상적으로 복원하지 않는 경우 압축된 USMT 마이그레이션 저장소에서 파일을 복구하는 옵션을 사용합니다. 옵션을 사용하는 /extract 방법에 대한 자세한 내용은 압축된 USMT 마이그레이션 저장소에서 파일 추출을 참조하세요.

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

/extract <filePath><destinationPath> [/i:<includePattern>] [/e: <excludePattern>] [/l: <logfile>] [/v: VerbosityLevel>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <filename>}] [/o]

명령줄 옵션 설명
<Filepath> USMT 마이그레이션 저장소의 경로입니다.

예시:
D:\MyMigrationStore\USMT\store.mig
<destinationPath> 도구에서 개별 파일을 배치하는 폴더의 경로입니다.
/i:<includePattern> 추출에 포함할 파일의 패턴을 지정합니다. 둘 이상의 패턴을 지정할 수 있습니다. 패턴을 쉼표 또는 세미콜론으로 구분합니다. /i:< includePattern> 및 /e: <excludePattern> 옵션은 동일한 명령에서 사용할 수 있습니다. 명령줄에서 포함 패턴과 제외 패턴을 모두 사용하는 경우 포함 패턴이 제외 패턴보다 우선합니다.
/e:<excludePattern> 추출에서 생략할 파일의 패턴을 지정합니다. 둘 이상의 패턴을 지정할 수 있습니다. 패턴을 쉼표 또는 세미콜론으로 구분합니다. /i:< includePattern> 및 /e: <excludePattern> 옵션은 동일한 명령에서 사용할 수 있습니다. 명령줄에서 포함 패턴과 제외 패턴을 모두 사용하는 경우 포함 패턴이 제외 패턴보다 우선합니다.
/l:<logfilePath> 로그 파일의 위치와 이름을 지정합니다.
/v:<VerbosityLevel> (세부 정보 표시)

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

VerbosityLevel은 다음 수준 중 하나로 설정할 수 있습니다.
  • 0 - 기본 오류 및 경고만 사용하도록 설정됩니다.
  • 1 - 자세한 출력을 사용하도록 설정합니다.
  • 4 - 오류 및 상태 출력을 사용하도록 설정합니다.
  • 5 - 자세한 정보 표시 및 상태 출력을 사용하도록 설정합니다.
  • 8 - 디버거에 대한 오류 출력을 사용하도록 설정합니다.
  • 9 - 디버거에 자세한 출력을 사용하도록 설정합니다.
  • 12 - 디버거에 대한 오류 및 상태 출력을 사용하도록 설정합니다.
  • 13 - 자세한 정보 표시, 상태 및 디버거 출력을 사용하도록 설정합니다.
/decrypt*<AlgID>/key:<KeyString>
or
/해독<AlgID>/:<"키 문자열">
or
/해독:<AlgID>/keyfile:<FileName>*		 옵션을 사용하여 ScanState 도구를 사용하여 마이그레이션 저장소를 만들도록 지정 /encrypt 합니다. 마이그레이션 저장소 /key 의 암호를 해독하려면 또는 /keyfile 옵션도 다음과 같이 지정해야 합니다.
  • <AlgID> 는 명령줄에서 마이그레이션 저장소를 만드는 데 사용된 암호화 알고리즘을 ScanState.exe 지정합니다. 알고리즘이 지정되지 않은 경우 ScanState 및 UsmtUtils 는 3DES 알고리즘을 기본값으로 사용합니다.
    <AlgID> 유효한 값은 AES_128, , AES_192AES_256, 3DES또는 3DES_112입니다.
  • /key: <KeyString> 은 암호화 키를 지정합니다. KeyString>에 공백이 있는< 경우 인수는 따옴표로 묶어야 합니다.
  • /keyfile:<FileName> 은 암호화 키가 포함된 텍스트(.txt) 파일을 지정합니다.

지원되는 암호화 알고리즘에 대한 자세한 내용은 마이그레이션 저장소 암호화를 참조하세요.
/O 기존 출력 파일을 덮어씁니다.

명령의 /extract 몇 가지 예:

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

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

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

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