LoadState 語法

本主題討論 LoadState 命令語法與選項。

在本主題中

在您開始前

語法

儲存選項

移轉規則選項

監視選項

使用者選項

不相容的命令列選項

在您開始前

執行 LoadState 命令之前，請注意下列各項：

• 若要確保所有作業系統設定都會移轉，建議您使用具有系統管理認證的帳戶在系統管理模式中執行 LoadState 命令。

• 如需執行 LoadState 命令時的軟體需求相關資訊，請參閱USMT 需求。

• 執行 LoadState 命令之後，您應該登出。下一次使用者登入之前，有些設定 (例如字型、底色圖案和螢幕保護裝置設定) 不會生效。

• 除非另外指定，否則在命令列上執行工具時，每個選項只能使用一次。

• LoadState 不需要網域控制站存取就可以套用網域設定檔。不需要使用額外的設定，就能使用這個功能。使用 ScanState 收集使用者設定檔時，來源電腦並不一定需要具備網域控制站的存取權。不過，在目的電腦加入網域之前，無法存取網域設定檔。

• 不相容的命令列選項 表格會列出您可以一起使用的選項，以及不相容的命令列選項。

語法

本節說明當您使用 LoadState 命令時，可以使用的命令列選項的語法與使用方式。這些選項可以透過任意順序加以指定。如果選項中包含參數，則可以指定冒號或空格分隔符號。

LoadState 命令的語法為：

loadstate 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]

例如，若要解密存放區並將檔案與設定移轉至執行 Windows Vista 或 Windows 7 的電腦，請在命令列中輸入下列命令：

loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"

儲存選項

USMT 會提供下列選項，讓您用來指定儲存所移轉資料的方式與位置。

命令列選項	說明
StorePath	指出儲存檔案與設定的資料夾。使用 LoadState 命令時，您必須指定 StorePath。您不可指定多個 StorePath。
/decrypt /key:KeyString 或 /decrypt /key:"Key String" 或 /decrypt /keyfile:[Path\]FileName	使用指定的金鑰解密存放區。使用這個選項時，您必須以下列其中一個方式指定加密金鑰： /key: KeyString 會指定加密金鑰。如果 KeyString 中含有空格，則必須用引號括住引數。 /keyfile: FilePathAndName 會指定其中包含加密金鑰的文字檔 (.txt) KeyString 不能超過 256 個字元。 /key 和 /keyfile 選項不可同時用於相同的命令列上。 /decrypt 和 /nocompress 選項不可同時用於相同的命令列上。 > [!IMPORTANT] > 使用此選項時請特別小心，因為可以存取 LoadState 命令列指令碼的任何人也都可以存取加密金鑰。 > 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /decrypt /key:mykey
/decrypt: "encryption strength"	/decrypt 選項會接受命令列參數，以定義針對移轉存放區加密所指定的加密強度。如需所支援加密演算法的相關資訊，請參閱移轉存放區加密。
/hardlink	可從永久連結移轉存放區中還原使用者狀態資料。/nocompress 參數必須與 /hardlink 選項一起指定。
/nocompress	指定不壓縮存放區。您應該只在測試環境中使用這個選項。建議您在實際移轉期間使用壓縮的存放區。這個選項不可以和 /decrypt 選項搭配使用。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /nocompress

移轉規則選項

USMT 會提供下列選項，讓您指定想要移轉的檔案。

命令列選項	說明
/i:[Path\]FileName	(include) 指定 .xml 檔案，其中包含會定義所要移轉狀態的規則。您可以多次指定這個選項，以包含所有 .xml 檔案 (MigApp.xml、MigSys.xml、MigDocs.xml 和任何建立的自訂 .xml 檔案)。Path 可以是相對或完整路徑。如果未指定 Path 變數，則 FileName 必須位於目前的目錄中。 如需要指定哪些檔案的相關資訊，請參閱常見問題集主題中的＜XML 檔案＞一節。
/config:[Path\]FileName	指定 LoadState 命令應該使用的 Config.xml 檔案。您不可以在命令列上多次指定這個選項。Path 可以是相對或完整路徑。如果未指定 Path 變數，則 FileName 必須位於目前的目錄中。 此範例會根據 Config.xml、MigDocs.xml 和 MigApp.xml 檔案中的規則來移轉檔案與設定： loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:loadstate.log
/auto: "path to script files"	這個選項可讓您指定預設 .xml 檔案的位置，然後啟動移轉。如果未指定路徑，USMT 會使用 USMT 二進位檔所在的目錄。/auto 選項的效用與使用下列選項相同：/i:MigDocs.xml/i:MigApp.xml /v:5。

監視選項

USMT 提供數個命令列選項，可讓您用來分析移轉期間發生的問題。

命令列選項	說明
/l:[Path\]FileName	指定 LoadState 記錄的位置與名稱。您不可在 StorePath 中儲存任何記錄檔。Path 可以是相對或完整路徑。如果未指定 Path 變數，則會在目前的目錄中建立記錄。您可以指定 /v 選項來調整輸出量。 如果從共用的網路資源中執行 LoadState 命令，您必須指定這個選項，否則 USMT 會失敗並出現錯誤：「USMT 無法建立記錄檔」。若要修正這個問題，請使用 /l:load.log 選項。
/v: <VerbosityLevel>	(Verbosity) 在 LoadState 記錄檔中啟用詳細資訊輸出。預設值為 0。 您可以將 VerbosityLevel 設為下列其中一個等級：   等級 說明 0 只會啟用預設錯誤和警告。 1 啟用詳細資訊輸出。 4 啟用錯誤和狀態輸出。 5 啟用詳細資訊和狀態輸出。 8 啟用將錯誤輸出至偵錯工具。 9 啟用將詳細資訊輸出至偵錯工具。 12 啟用將錯誤和狀態輸出至偵錯工具。 13 啟用詳細資訊、狀態和偵錯工具輸出。 </div> <p>例如：</p> <p> <code>loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml</code> </p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/progress:</strong>[<em>Path\</em>]<em>FileName</em></p> </td> <td colspan="1"> <p>建立選用進度記錄。您不可在 <em>StorePath</em> 中儲存任何記錄檔。<em>Path</em> 可以是相對或完整路徑。如果未指定 <em>Path</em> 變數，則會在目前的目錄中建立 <em>FileName</em>。</p> <p>例如：</p> <p> <code>loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code> </p> </td> </tr> <tr> <td> <p> <strong>/c</strong> </p> </td> <td> <p>已指定此選項時，即使發生非嚴重錯誤，<strong>LoadState</strong> 命令仍會繼續執行。所有導致錯誤的檔案或設定都會記錄在進度記錄中。例如，如果大型檔案無法放入電腦中，則 <strong>LoadState</strong> 命令會記錄錯誤並繼續進行移轉。未使用 <strong>/c</strong> 選項時，<strong>LoadState</strong> 命令會在出現第一個錯誤時結束。您可以使用 Config.xml 檔案中新的 &lt;<strong>ErrorControl</strong>&gt; 區段，指定可以放心略過哪些檔案或登錄讀取/寫入錯誤，以及哪些可能導致移轉失敗。這可讓 <strong>/c</strong> 命令列選項放心略過您環境中所有的輸入/輸出 (I/O) 錯誤。此外，<strong>/genconfig</strong> 選項現在產生了範例 &lt;<strong>ErrorControl</strong>&gt; 區段，在 Config.xml 檔案中指定錯誤訊息和所需的行為即可啟用該區段。</p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/r:</strong> <em>&lt;TimesToRetry&gt;</em> </p> </td> <td colspan="2"> <p> <strong>(重試)</strong> </p> <p>指定從伺服器移轉使用者狀態但發生錯誤時，會重試的次數。預設為三次。在網路連線能力不穩定的環境中，這個選項十分有用。</p> <p>在還原使用者狀態時，<strong>/r</strong> 選項將不會復原由於網路硬體故障 (例如網路纜線有問題或中斷連線)，或者虛擬私人網路 (VPN) 連線失敗而遺失的資料。重試選項適用於連線能力良好，但通訊延遲問題嚴重的大型忙碌網路。</p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/w:</strong> <em>&lt;SecondsBeforeRetry&gt;</em> </p> </td> <td colspan="2"> <p> <strong>(等候)</strong> </p> <p>指定在重試網路檔案作業之前，要等候的時間 (以秒為單位)。預設是 1 秒。</p> </td> </tr> <tr> <td colspan="1"> <p> <strong>/?</strong> 或 <strong>/help</strong></p> </td> <td colspan="2"> <p>在命令列中顯示說明。</p> </td> </tr> </table> 使用者選項 根據預設，會移轉所有使用者。指定要包含及排除哪些使用者的唯一方式為使用下列選項。您無法排除移轉 .xml 檔案中的使用者，或使用 Config.xml 檔案來排除。如需詳細資訊，請參閱識別使用者。 命令列選項 說明 /all 移轉電腦上所有的使用者。 除非明確使用 /ue 或 /uel 選項來排除帳戶，否則 USMT 會移轉電腦上的所有使用者帳戶。因此，您不需要在命令列上指定這個選項。不過，如果選擇使用 /all 選項，則無法也使用 /ui、/ue 或 /uel 選項。 /ui: DomainName\UserName 或 /ui:"DomainName\User Name" 或 /ui: ComputerName\LocalUserName (包含使用者) 移轉指定的使用者。根據預設，移轉中會包含所有使用者。因此，這個選項只有與 /ue 選項搭配使用時才有幫助。您可以指定多個 /ui 選項，但無法搭配使用 /ui 選項與 /all 選項。DomainName 和 UserName 中可以包含星號 (*) 萬用字元。當您指定的使用者名稱中含有空格時，必須以引號括住該名稱。 例如： 若要在 Corporate 網域中只包含 User2，請輸入： /ue:*\* /ui:corporate\user2 備註 如果使用 /ui 選項指定包含某個使用者，而且也使用 /ue 或 /uel 選項指定排除該使用者，則移轉中會包含該使用者。 如需相關範例，請參閱這個表格中有關 /uel、/ue 和 /ui 選項的說明。 /uel:<NumberOfDays> 或 /uel:<YYYY/MM/DD> 或 /uel:0 (依據上次登入排除使用者) 依據來源電腦上 Ntuser.dat 檔案的上次修改日期，僅移轉在指定時間間隔內已登入來源電腦的使用者。/uel 選項可做為包含規則。例如，/uel:30 選項會移轉執行 ScanState 命令當天到前 30 天以內，已登入或已修改其帳戶的使用者。 您可以指定天數或指定日期。這個選項不可以和 /all 選項搭配使用。USMT 會從本機電腦擷取上次登入資訊，因此執行這個選項時，電腦不需要連線到網路。此外，如果網域使用者已登入其他電腦，USMT 不會處理該登入執行個體。 備註 離線移轉則不可使用 /uel 選項。 範例： 執行 ScanState 命令時，/uel:0 會移轉已登入來源電腦的帳戶。 /uel:90 會移轉在最近 90 天內，已登入或已修改其帳戶的使用者。 /uel:1 則會移轉前 24 小時內，已修改其帳戶的使用者。 /uel:2002/1/15 會移轉自 2002 年 1 月 15 日以來，已登入或已修改其帳戶的使用者。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0 /ue:DomainName\UserName 或 /ue:"DomainName\User Name" 或 /ue:ComputerName\LocalUserName (排除使用者) 從移轉中排除指定的使用者。您可以指定多個 /ue 選項，但無法搭配使用 /ue 選項與 /all 選項。DomainName 和 UserName 中可以包含星號 (*) 萬用字元。當您指定的使用者名稱中含有空格時，必須以引號括住該名稱。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /ue:contoso\user1 如需相關範例，請參閱這個表格中有關 /uel、/ue 和 /ui 選項的說明。 /md: OldDomain:NewDomain 或 /md: LocalComputerName:NewDomain (移動網域) 指定使用者的新網域。使用這個選項，即可變更電腦上的使用者網域，或將本機使用者移轉至網域帳戶。OldDomain 中可以包含星號 (*) 萬用字元。 您可以多次指定這個選項。如果正在將多個網域中的使用者合併到單一網域，就可以指定多個 /md 選項。例如，您可以指定下列命令，將 Corporate 和 FarNorth 網域的使用者合併到 Fabrikam 網域：/md:corporate:fabrikam 和 /md:farnorth:fabrikam。 如果兩個 /md 命令之間發生衝突，則會套用指定的第一個規則。例如，如果指定 /md:corporate:fabrikam 和 /md:corporate:farnorth 命令，則 Corporate 使用者會對應到 Fabrikam 網域。 備註 如果指定不存在於來源電腦上的 OldDomain，LoadState 命令會顯示順利完成，不會出現錯誤或警告。不過在此情況下，使用者不會移至 NewDomain，而是留在原始網域中。例如，如果拼錯 "contoso" 而且指定 "/md:contso:fabrikam"，使用者會留在目的電腦的 contoso 中。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:load.log /md:contoso:fabrikam /mu: OldDomain\OldUserName:[NewDomain\]NewUserName 或 /mu: OldLocalUserName:NewDomain\NewUserName 指定所指定之使用者的新使用者名稱。如果存放區中包含多位使用者，則可以指定多個 /mu 選項。在這個選項中不可使用萬用字元。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:load.log /mu:contoso\user1:fabrikam\user1 /lac:[Password] (建立本機帳戶) 指定如果使用者帳戶是本機 (非網域) 帳戶，而且不在目的電腦上，USMT 會在目的電腦上建立帳戶，但是會停用該帳戶。若要啟用帳戶，您也必須使用 /lae 選項。 如果未指定 /lac 選項，將不會移轉目的電腦上不存在的任何本機使用者帳戶。 Password 是新建帳戶的密碼。根據預設，會使用空白密碼。 注意 使用 Password 變數時請特別小心，因為會以純文字提供密碼，而且可以存取執行 LoadState 命令之電腦的每個人都可取得此密碼。 如果電腦有多位使用者，所有移轉的使用者也都會擁有相同的密碼。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore 如需相關指示，請參閱移轉使用者帳戶。 /lae (啟用本機帳戶) 啟用透過 /lac 選項建立的帳戶。必須使用此選項來指定 /lac 選項。 例如： loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:load.log /lac:password /lae 如需相關指示，請參閱移轉使用者帳戶。 /ui 和 /ue 選項的範例 下列範例同時適用於 /ui 和 /ue 選項。您可以使用 /ui 選項來取代 /ue 選項，包含 (而不是排除) 指定的使用者。 行為 命令 排除 Corporate 網域中，名稱為 User One 的使用者。 /ue:"corporate\user one" 排除 Corporate 網域中，名稱為 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，則如果在 14 天內登入電腦，就會移轉 User1。 行為 命令 僅包含 Fabrikam 網域的 User2，並排除所有其他使用者。 /ue:*\* /ui:fabrikam\user2 僅包含名稱為 User1 的本機使用者，並排除所有其他使用者。 /ue:*\* /ui:user1 僅包含 Contoso 的網域使用者，Contoso\User1 除外。 這個行為無法使用單一命令來完成。若要移轉這組使用者，您必須改為指定下列項目： 使用 ScanState 命令列工具，輸入：/ue:*\* /ui:contoso\* 使用 LoadState 命令列工具，輸入：/ue:contoso\user1 僅包含本機 (非網域) 使用者。 /ue:*\* /ui:%computername%\* 不相容的命令列選項 下表指出與 LoadState 命令不相容的命令列選項。如果特定組合的表格項目為空白，則為相容選項而且可以一起使用。X 符號表示選項不相容。例如，您無法將 /nocompress 選項與 /encrypt 選項搭配使用。 命令列選項 /keyfile /nocompress /genconfig /all /i /v /nocompress 無 X /key X X /decrypt 必要* X X /keyfile 無 X /l /progress X /r X /w X /c X /p X 無 /all X /ui X X /ue X X /uel X X /genconfig 無 /config X StorePath /md /mu /lae /lac 備註 您必須指定 /key 或 /keyfile 選項與 /encrypt 選項搭配使用。 另請參閱 其他資源 XML 元素庫