共用方式為

UsmtUtils 語法

本文說明用戶狀態移轉工具中可用的公用程式語法， (USMT) 透過命令行介面。 這些公用程式：

  • 改善判斷移轉密碼編譯選項的能力。

  • 協助移除因共用鎖定而無法刪除的硬式連結存放區。

  • 確認已壓縮移轉存放區中的類別目錄檔案或任何其他檔案是否已損毀。

  • 從檔案和設定移轉至目的地計算機時所建立的壓縮移轉存放區中擷取檔案。

UsmtUtils.exe

下表列出的 UsmtUtils.exe命令列選項。 下列各節提供 和 選項的/extract進一步命令行選項/verify。

的語 UsmtUtils.exe 法為：

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

命令行選項 描述
/電子商務 傳回目前系統上支持的密碼編譯演算法清單 (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。 傳回已壓縮移轉存放區中所有檔案的索引標籤分隔清單，以及每個檔案的狀態。 每一行都包含檔名，後面接著索引標籤間距，以及視檔案的狀態而定，已 損毀 或 確定 。 最後一個專案會報告存放區 CATALOG 的損毀狀態。 目錄檔案包含移轉存放區中所有檔案的元數據。 LoadState 工具需要有效的類別目錄檔案，才能開啟移轉存放區。 如果類別目錄檔案完整，且 LoadState 可以開啟移轉存放區，而且如果移轉存放區損毀，則傳回 “CORRUPTED”。
  • failureonly。 只傳回已壓縮移轉存放區中已損毀檔案的索引卷標分隔清單。
  • 目錄。 只傳回目錄檔案的狀態。
/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>		 指定 /encrypt 使用 ScanState 工具來建立移轉存放區的選項。 若要解密移轉存放區，請指定 /key 或 /keyfile 選項，如下所示：
  • <AlgID> 會指定用來在命令行上 ScanState.exe 建立移轉存放區的密碼編譯演算法。 如果未指定任何演算法， ScanState 和 UsmtUtils 會使用 3DES 演算法作為預設值。
    <AlgID> 的有效值包括： AES_128、 AES_192、 AES_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

擷取

/extract如果無法使用 LoadState 正常還原，請使用 選項從壓縮的 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> 指定要包含在擷取中的檔案模式。 可以指定一個以上的模式。 使用逗號或分號分隔模式。 ：<includePattern>/i和 /e： <excludePattern> 選項可以在相同的命令中使用。 當命令行上同時使用 include 和 exclude 模式時，包含模式的優先順序高於排除模式。
/e：<excludePattern> 指定要從擷取中省略檔案的模式。 可以指定一個以上的模式。 使用逗號或分號分隔模式。 ：<includePattern>/i和 /e： <excludePattern> 選項可以在相同的命令中使用。 當命令行上同時使用 include 和 exclude 模式時，包含模式的優先順序高於排除模式。
/l：<logfilePath> 指定記錄檔的位置和名稱。
/v：<VerbosityLevel> (詳細資訊)

在 UsmtUtils 記錄檔中啟用詳細信息輸出。 預設值為 0。

VerbosityLevel 可以設定為下列其中一個層級：
  • 0 - 只啟用預設錯誤和警告。
  • 1 - 啟用詳細信息輸出。
  • 4 - 啟用錯誤和狀態輸出。
  • 5 - 啟用詳細資訊和狀態輸出。
  • 8 - 啟用調試程序的錯誤輸出。
  • 9 - 啟用調試程序的詳細信息輸出。
  • 12 - 啟用調試程序的錯誤和狀態輸出。
  • 13 - 啟用詳細資訊、狀態和調試程序輸出。
/decrypt*<AlgID>/key：<KeyString>
or
/解密<AlgID>/：<“Key String”>
or
/解密：<AlgID>/keyfile：<FileName>*		 指定 /encrypt 使用 ScanState 工具來建立移轉存放區的選項。 若要解密移轉存放區， /key 也必須指定 或 /keyfile 選項，如下所示：
  • <AlgID> 會指定用來在命令行上 ScanState.exe 建立移轉存放區的密碼編譯演算法。 如果未指定任何演算法， ScanState 和 UsmtUtils 會使用 3DES 演算法作為預設值。
    <AlgID> 的有效值包括： AES_128、 AES_192、 AES_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