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

note備註
如果使用 /ui 選項指定包含某個使用者，而且也使用 /ue 或 /uel 選項指定排除該使用者，則移轉中會包含該使用者。

如需相關範例，請參閱這個表格中有關 /uel、/ue 和 /ui 選項的說明。

/uel:<NumberOfDays>

或

/uel:<YYYY/MM/DD>

或

/uel:0

(依據上次登入排除使用者)

依據來源電腦上 Ntuser.dat 檔案的上次修改日期，僅移轉在指定時間間隔內已登入來源電腦的使用者。/uel 選項可做為包含規則。例如，/uel:30 選項會移轉執行 ScanState 命令當天到前 30 天以內，已登入或已修改其帳戶的使用者。

您可以指定天數或指定日期。這個選項不可以和 /all 選項搭配使用。USMT 會從本機電腦擷取上次登入資訊，因此執行這個選項時，電腦不需要連線到網路。此外，如果網域使用者已登入其他電腦，USMT 不會處理該登入執行個體。

note備註
離線移轉則不可使用 /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 網域。

note備註
如果指定不存在於來源電腦上的 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 是新建帳戶的密碼。根據預設，會使用空白密碼。

Caution注意
使用 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

note備註
您必須指定 /key 或 /keyfile 選項與 /encrypt 選項搭配使用。

另請參閱

其他資源

XML 元素庫