LoadState 語法
命令 LoadState.exe
會與用戶狀態移轉工具 (USMT) 搭配使用,以將命令先前擷 ScanState.exe
取的存放區還原至目的地計算機。 本文討論 LoadState.exe
命令語法及其可用的選項。
開始之前
執行 LoadState.exe
命令之前,請注意下列專案:
若要確保所有作業系統設定都會移轉,Microsoft建議您從具有系統管理認證的
LoadState.exe
帳戶,以系統管理員模式執行命令。如需執行命令的軟體需求相關
LoadState.exe
信息,請參閱 USMT 需求。執行命令之後註銷
LoadState.exe
。 某些設定,例如範例、字型、桌布和屏幕保護設定,在使用者下次登入之前不會生效。除非另有指定,否則每個選項只能在從命令行執行工具時使用一次。
LoadState 不需要域控制器存取權即可套用網域配置檔。 這項功能不需要任何其他設定即可使用。 使用 ScanState 收集使用者配置檔時,來源電腦不需要有域控制器存取權。 不過,在目的地計算機加入網域之前,無法存取網域配置檔。
[ 不相容的命令行選項 ] 數據表會列出哪些選項可以一起使用,以及哪些命令行選項不相容。
語法
本節說明使用 命令時可用命令行選項的 LoadState.exe
語法和使用方式。 您可以依任何順序指定選項。 如果選項包含參數,則可以指定冒號或空格分隔符。
命令 LoadState.exe
的語法為:
LoadState.exe 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]
例如,若要解密存放區,並將檔案和設定移轉至計算機,請輸入下列命令:
LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"
記憶體選項
USMT 提供下列選項,可用來指定移轉數據的儲存方式和位置。
Command-Line 選項 | 描述 |
---|---|
StorePath | 指出儲存檔案和設定數據的資料夾。 使用 LoadState.exe 命令時,必須指定 StorePath。 無法指定多個 StorePath 。 |
/decrypt /key:KeyString or /decrypt /key:“Key String” or /decrypt /keyfile:[Path]FileName |
使用指定的金鑰解密存放區。 使用這個選項時,必須以下欄其中一種方式指定加密金鑰:
KeyString 不能超過 256 個字元。 和 /key /keyfile 選項不能在相同的命令行上使用。和 /decrypt /nocompress 選項不能在相同的命令行上使用。
重要 使用或 keyfile 選項時請/key 小心。 例如,任何有權存取使用這些選項執行命令之 LoadState.exe 腳本的人,也都可以存取加密密鑰。例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
/decrypt:“加密強度” | 選項 /decrypt 會接受命令行參數,以定義針對移轉存放區加密指定的加密強度。 如需支援之加密演算法的詳細資訊,請參閱 移轉存放區加密。 |
/hardlink | 可讓用戶狀態數據從硬式連結移轉存放區還原。 參數 /nocompress 必須使用 /hardlink 選項來指定。 |
/nocompress | 指定不會壓縮存放區。 此選項只能用於測試環境中。 Microsoft建議在實際移轉期間使用壓縮存放區。 此選項無法與 選項搭配 /decrypt 使用。例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
移轉規則選項
USMT 提供下列選項來指定要移轉的檔案。
Command-Line 選項 | 描述 |
---|---|
/i:[Path]FileName |
(包含) 指定 .xml 檔案,其中包含定義要移轉之數據的規則。 您可以多次指定此選項,以包含 、 和 (的所有 .xml 檔案 MigApp.xml MigSys.xml MigDocs.xml ,以及) 建立的任何自定義 .xml 檔案。
路徑 可以是相對路徑或完整路徑。 如果未指定 Path 變數, 則FileName 必須位於當前目錄中。For more information about which files to specify, see the "XML files" section of the Frequently Asked Questions article. |
/config:[Path]FileName | 指定 Config.xml 命令應該使用的檔案 LoadState.exe 。 這個選項不能在命令列上指定一次以上。
路徑 可以是相對路徑或完整路徑。 如果未指定 Path 變數, 則FileName 必須位於當前目錄中。此範例會根據、 MigDocs.xml 與檔案中的Config.xml 規則來移轉檔案和MigApp.xml 設定:LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
/auto:“腳本檔案的路徑” | 此選項可指定預設 .xml 檔案的位置。 如果未指定路徑,USMT 會使用USMT二進位檔所在的目錄。 選項 /auto 的效果與使用下列選項相同: /i:MigDocs.xml /i:MigApp.xml /v:5 。 |
監視選項
USMT 提供數個命令行選項,可用來分析移轉期間發生的問題。
Command-Line 選項 | 描述 |
---|---|
/l:[Path]FileName | 指定 LoadState 記錄檔的位置和名稱。 記錄檔無法儲存在 StorePath 中。
路徑 可以是相對路徑或完整路徑。 如果未指定 Path 變數,則會在當前目錄中建立記錄檔。
/v 您可以指定 選項來調整記錄的詳細資訊。如果從共享網路資源執行 LoadState.exe 命令, l 則必須指定 選項,否則 USMT 會失敗並出現錯誤:USMT 無法建立記錄檔 () 若要修正此問題,請務必在從共用網路資源執行時 LoadState.exe 指定 /l 選項。 |
/v:<VerbosityLevel> |
(詳細資訊) 啟用 LoadState 記錄檔中的詳細信息輸出。 預設值為 0。 VerbosityLevel 可以設定為下列其中一個層級:
例如: LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml |
/progress:[Path]FileName | 建立選擇性的進度記錄。 記錄檔無法儲存在 StorePath 中。
路徑 可以是相對路徑或完整路徑。 如果未指定 Path 變數,則會在當前目錄中建立 FileName 。 例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log |
/c | 指定此選項時, LoadState.exe 即使發生非嚴重錯誤,命令仍會繼續執行。 造成錯誤的任何檔案或設定都會記錄在進度記錄中。 例如,如果電腦上有無法容納的大型檔案, LoadState.exe 此命令會記錄錯誤並繼續進行移轉。 如果沒有 選項 /c , LoadState.exe 命令就會在第一個錯誤時結束。
ErrorControl>< 區段可用於 檔案中Config.xml ,以指定可以安全地忽略哪些檔案或登錄讀取/寫入錯誤,而這可能會導致移轉失敗。 此錯誤控制項可 /c 讓命令行選項安全地略過環境中的所有輸入/輸出 (I/O) 錯誤。 此外,此 /genconfig 選項現在會產生範例 <ErrorControl> 區段,並藉由在檔案中 Config.xml 指定錯誤訊息和所需的行為來啟用此區段。 |
/r:<TimesToRetry> |
(重試) 指定從伺服器移轉用戶狀態時發生錯誤時要重試的次數。 預設值為三次。 此選項在網路連線不可靠的環境中很有用。 還原用戶狀態時, /r 選項不會復原因網路硬體故障而遺失的數據,例如網路硬體故障或中斷連線的網路纜線,或虛擬專用網 (VPN) 連線失敗時。 重試選項適用於連線令人滿意,但通訊延遲是問題的大型忙碌網路。 |
/w:<SecondsBeforeRetry> |
(等候) 指定在重試網路檔案作業之前等候的時間,以秒為單位。 預設值為 1 秒。 |
/? 或 /help | 在命令行上顯示說明。 |
用戶選項
根據預設,所有用戶都會移轉。 指定要包含和排除哪些使用者的唯一方法是使用下列選項。 無法在移轉 .xml 檔案中或使用 Config.xml
檔案來排除使用者。 如需詳細資訊,請 參閱識別使用者。
Command-Line 選項 | 描述 |
---|---|
/都 | 移轉電腦上的所有使用者。 除非使用 或 /uel 選項明確排除/ue 帳戶,否則 USMT 會移轉電腦上的所有用戶帳戶。 基於這個理由,不需要在命令行上指定此選項。 不過,如果使用 /all 選項, /ui 則也無法使用、 /ue 或 /uel 選項。 |
/ui:DomainName UserName or /ui:“DomainName 用戶名稱” or /ui:ComputerName LocalUserName |
(使用者包含) 移轉指定的使用者。 根據預設,所有用戶都會包含在移轉中。 因此,只有在搭配 選項使用時, /ue 此選項才有説明。 您可以指定多個 /ui 選項,但 /ui 選項無法與 選項搭配 /all 使用。
DomainName 和 UserName 可以包含星號 () * 通配符。 指定包含空格的用戶名稱時,必須以引弧括住 (" ) 。例如,若只要包含來自公司網域的 User2 ,請輸入: /ue:* /ui:corporate\user2
注意 如果指定要包含 /ui 選項的使用者,而且也指定要使用 /ue 或 /uel 選項排除使用者,則使用者會包含在移轉中。如需更多範例,請參閱此表格中 /uel 、 /ue 和 /ui 選項的描述。 |
/uel:<NumberOfDays> or /uel: <YYYY/MM/DD> or /uel:0 |
(根據上次登入) 排除使用者 根據來源計算機上Ntuser.dat檔案的上次修改日期,只移轉在指定時段內登入來源計算機的使用者。 選項 /uel 會作為 include 規則。 例如, /uel:30 選項會移轉在命令執行日期的過去 30 天內登入或修改其使用者帳戶的 ScanState.exe 使用者。 可以指定天數,或可以指定日期。 此選項無法與 選項搭配 /all 使用。 USMT 會從本機計算機擷取最後一個登入資訊,因此計算機在執行此選項時不需要連線到網路。 此外,如果網域使用者登入另一部計算機,USMT 不會考慮該登入實例。
注意 此 /uel 選項在離線移轉中無效。範例:
例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0 |
/ue:DomainName\UserName or /ue“DomainName\User Name” or /ue:ComputerName\LocalUserName |
(使用者排除) 從移轉中排除指定的使用者。 您可以使用多個 /ue 選項, /ue 但選項無法與 選項搭配 /all 使用。
DomainName 和 UserName 可以包含星號 () * 通配符。 指定包含空格的用戶名稱時,必須以引弧括住 (" ) 。例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1 如需更多範例,請參閱此表格中 /uel 、 /ue 和 /ui 選項的描述。 |
/md:OldDomain:NewDomain or /md:LocalComputerName:NewDomain |
(移動網域) 指定使用者的新網域。 使用此選項可變更電腦上使用者的網域,或將本機使用者移轉至網域帳戶。 OldDomain 可能包含星號 () 通配符。 這個選項可以指定一次以上。 如果將使用者跨多個網域合併到單一網域,可能需要指定多個 /md 選項。 例如,若要將來自公司網域和 FarNorth 網域的使用者合併到 Fabrikam 網域,請指定下列設定: 和 /md:farnorth:fabrikam 。 /md:corporate:fabrikam 如果兩 /md 個命令之間發生衝突,則會套用第一個指定的規則。 例如,如果 /md:corporate:fabrikam 指定和 /md:corporate:farnorth 命令,則公司用戶會對應至 Fabrikam 網域。
注意 如果指定了來源計算機上不存在的網域, LoadState.exe 命令看起來會順利完成,而不會出現錯誤或警告。 不過,在此情況下,使用者不會移至 NewDomain ,而是保留在其原始網域中。 例如,如果 contoso 拼錯,而是指定 /md:contso:fabrikam ,則使用者會保留在目的地電腦上的 contoso 中。例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:LoadState.log /md:contoso:fabrikam |
/mu:OldDomain OldUserName:[NewDomain]NewUserName or /mu:OldLocalUserName:NewDomain NewUserName |
(移動使用者) 指定指定之使用者的新用戶名稱。 如果存放區包含多個使用者,則可以指定多個 /mu 選項。 通配符無法與這個選項搭配使用。例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1 |
/lac:[Password] |
(本機帳戶建立) 如果使用者帳戶為:
/lae 也必須使用 選項。如果未指定選項 /lac ,則不會移轉目的地計算機上尚未存在的任何本機用戶帳戶。密碼 是新建立之帳戶的密碼。 預設會使用空白密碼。
注意 請小心使用 Password 變數。 密碼變數是以純文本提供,而且任何能夠存取執行命令之計算機 LoadState.exe 的人員都可以取得密碼。此外,如果計算機有多個使用者,則所有移轉的使用者都有相同的密碼。 例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore 如需指示,請 參閱移轉用戶帳戶。 |
/lae |
(本機帳戶啟用) 啟用使用 選項建立的 /lac 帳戶。 此 /lac 選項必須使用這個選項來指定。例如: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:LoadState.log /lac:password /lae 如需指示,請 參閱移轉用戶帳戶。 |
/ui 和 /ue 選項的範例
下列範例適用於 /ui 和 /ue 選項。 /ue 選項可以取代為 /ui 選項,以包含而不是排除指定的使用者。
行為 | 命令 |
---|---|
在公司網域中排除名為User One的使用者。 | /ue:"corporate\user one" |
在公司網域中排除名為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
指定 ,則會移轉 User1,因為 /ui
選項優先於 /ue
選項。
/uel 選項的優先順序高於 /ue 選項。 如果使用者在選項所 /uel
設定的指定時段內登入,即使使用者的配置檔已使用 選項排除,也會移轉該使用者的 /ue
配置檔。 例如,如果 /ue:contoso\user1 /uel:14
指定 ,則如果User1在過去14天內登入電腦,則會將其移轉。
行為 | 命令 |
---|---|
只包含 Fabrikam 網域中的 User2,並排除所有其他使用者。 | /ue:* /ui:fabrikam\user2 |
只包含名為User1的本機使用者,並排除所有其他使用者。 | /ue:* /ui:user1 |
只包含 Contoso 的網域使用者,但 Contoso\User1 除外。 | 無法使用單一命令來完成此行為。 相反地,若要移轉這組使用者,請指定下列選項:
|
只包含本機 (非網域) 使用者。 | /ue: /ui:%computername%* |
不相容的命令行選項
下表指出哪些命令行選項與 LoadState.exe
命令不相容。 如果特定組合的數據表專案具有 ✅,則選項是相容的,而且可以一起使用。 符號 ❌ 表示選項不相容。 例如, /nocompress
選項無法與 選項搭配 /encrypt
使用。
Command-Line 選項 | /keyfile | /nocompress | /genconfig | /都 |
---|---|---|---|---|
/我 | ✅ | ✅ | ✅ | ✅ |
/v | ✅ | ✅ | ✅ | ✅ |
/nocompress | ✅ | 無 | ❌ | ✅ |
/鑰匙 | ❌ | ✅ | ❌ | ✅ |
/解密 | 必填* | ❌ | ❌ | ✅ |
/keyfile | 無 | ✅ | ❌ | ✅ |
/l | ✅ | ✅ | ✅ | ✅ |
/進展 | ✅ | ✅ | ❌ | ✅ |
/r | ✅ | ✅ | ❌ | ✅ |
/w | ✅ | ✅ | ❌ | ✅ |
/c | ✅ | ✅ | ❌ | ✅ |
/p | ✅ | ✅ | ❌ | 無 |
/都 | ✅ | ✅ | ❌ | ✅ |
/用戶介面 | ✅ | ✅ | ❌ | ❌ |
/ue | ✅ | ✅ | ❌ | ❌ |
/uel | ✅ | ✅ | ❌ | ❌ |
/genconfig | ✅ | ✅ | 無 | ✅ |
/config | ✅ | ✅ | ❌ | ✅ |
StorePath | ✅ | ✅ | ✅ | ✅ |
/md | ✅ | ✅ | ✅ | ✅ |
/木 | ✅ | ✅ | ✅ | ✅ |
/lae | ✅ | ✅ | ✅ | ✅ |
/紫膠 | ✅ | ✅ | ✅ | ✅ |
注意
/key
/keyfile
或選項必須使用 /decrypt
選項來指定。