UsmtUtils 語法
本主題描述 使用者狀態移轉工具 (USMT) 5.0 中可透過命令列介面使用的公用程式語法。這些公用程式讓您能：
提升能力以決定移轉的密碼編譯選項。
協助移除由於共用鎖定而無法刪除的永久連結存放區。
驗證壓縮移轉存放區中的類別目錄檔案或任何其他檔案是否損毀。
當您將檔案和設定移轉至目的電腦時，從壓縮移轉存放區擷取檔案。
在本主題中
Usmtutils.exe
驗證選項
擷取選項
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> 引數指定的目錄路徑。您可以使用這個命令來刪除由於共用鎖定而無法在命令提示字元刪除的永久連結移轉存放區。如果移轉存放區分佈在指定磁碟機的多個磁碟區中，就會將它從所有這些磁碟區中刪除。 例如：
|
/y |
搭配 /rd 選項一起使用時，會覆寫接受刪除提示。將 /y 選項搭配 /rd 選項一起使用時，在 USMT 刪除目錄之前，不會提示您接受刪除。 |
/verify |
傳回壓縮移轉存放區是否完整，或者是否包含損毀的檔案或損毀的類別目錄等相關資訊。 請參閱驗證選項以取得可與 /verify 搭配使用的語法和選項。 |
/extract |
從壓縮 USMT 移轉存放區復原檔案。 請參閱擷取選項以取得可與 /extract 搭配使用的語法和選項。 |
驗證選項
當您想判斷壓縮移轉存放區是否完整，或者是否包含損毀的檔案或損毀的類別目錄時，請使用 /verify 選項。如需如何使用 /verify 選項的相關資訊，請參閱驗證壓縮移轉存放區的狀況。
/verify 的語法為：
usmtutils /verify[:<reportType>] <filePath> [/l:<logfile>] [/v:VerbosityLevel] [/decrypt [:<AlgID>] {/key:<keystring> | /keyfile:<filename>}]
| 命令列選項 | 說明 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<reportType> |
指定是否報告所有檔案、只報告損毀的檔案或者類別目錄的狀態。
|
||||||||||||||||||
/l: <logfilePath> |
指定記錄檔的位置和名稱。 |
||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) 在 UsmtUtils 記錄檔中啟用詳細資訊輸出。預設值為 0。 您可以將 VerbosityLevel 設為下列其中一個等級：
|
||||||||||||||||||
/decrypt: <AlgID> /key:<KeyString> 或 /decrypt: <AlgID> /key:<“Key String”> 或 /decrypt: <AlgID> /keyfile:<FileName> |
指定以 ScanState 工具用來建立移轉存放區的 /encrypt 選項。若要解密移轉存放區，請指定 /key 或 /keyfile 選項，如下所示：
如需所支援加密演算法的相關資訊，請參閱移轉存放區加密 |
部分的 /verify 命令範例：
usmtutils /verify D:\MyMigrationStore\store.migusmtutils /verify:catalog D:\MyMigrationStore\store.migusmtutils /verify:all D:\MyMigrationStore\store.mig /decrypt /l:D:\UsmtUtilsLog.txtusmtutils /verify:failureonly D:\MyMigrationStore\store.mig /decrypt:AES_192 /keyfile:D:\encryptionKey.txt
擷取選項
如果使用 loadstate 無法正常還原，請使用 /extract 選項，從壓縮 USMT 移轉存放區復原檔案。如需如何使用 /extract 選項的相關資訊，請參閱從壓縮 USMT 移轉存放區擷取檔案。
/extract 的語法為：
/extract <filePath><destinationPath> [/i:<includePattern>] [/e: <excludePattern>] [/l: <logfile>] [/v: VerbosityLevel>] [/decrypt[:<AlgID>] {key: <keystring> | /keyfile: <filename>}] [/o]
| 命令列選項 | 說明 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<filePath> |
USMT 移轉存放區路徑。 例如：
|
||||||||||||||||||
<destinationPath> |
工具存放個別檔案所在的資料夾路徑。 |
||||||||||||||||||
/i:<includePattern> |
指定擷取時要包含的檔案模式。您可以指定多個模式。使用逗點或分號來分隔模式。您可以在相同的命令中使用 /i: <includePattern> 和 /e: <excludePattern> 選項。在命令列使用包含和排除模式時，包含模式的優先順序會高於排除模式。 |
||||||||||||||||||
/e:<excludePattern> |
指定擷取時要略過的檔案模式。您可以指定多個模式。使用逗點或分號來分隔模式。您可以在相同的命令中使用 /i: <includePattern> 和 /e: <excludePattern> 選項。在命令列使用包含和排除模式時，包含模式的優先順序會高於排除模式。 |
||||||||||||||||||
/l:<logfilePath> |
指定記錄檔的位置和名稱。 |
||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) 在 UsmtUtils 記錄檔中啟用詳細資訊輸出。預設值為 0。 您可以將 VerbosityLevel 設為下列其中一個等級：
|
||||||||||||||||||
/decrypt: <AlgID> /key:<KeyString> 或 /decrypt: <AlgID> /key:<“Key String”> 或 /decrypt: <AlgID> /keyfile:<FileName> |
指定以 ScanState 工具用來建立移轉存放區的 /encrypt 選項。若要解密移轉存放區，也必須指定 /key 或 /keyfile 選項，如下所示；
如需所支援加密演算法的相關資訊，請參閱移轉存放區加密 |
||||||||||||||||||
/o |
覆寫現有的輸出檔。 |
部分的**/extract** 命令範例：
usmtutils /extract D:\MyMigrationStore\USMT\store.mig C:\ExtractedStoreusmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:"*.txt, *.pdf" C:\ExtractedStore /decrypt /keyfile:D:\encryptionKey.txtusmtutils /extract D:\MyMigrationStore\USMT\store.mig /e:*.exe C:\ExtractedStore /decrypt:AES_128 /key:password /l:C:\usmtlog.txtusmtutils /extract D:\MyMigrationStore\USMT\store.mig /i:myProject.* /e:*.exe C:\ExtractedStore /o