ScanState 語法
ScanState 命令會與使用者狀態移轉工具 (USMT) 5.0 搭配使用,以掃描來源電腦、收集檔案與設定以及建立存放區。
在本主題中
在您開始前
語法
儲存選項
移轉規則選項
監視選項
使用者選項
加密的檔案選項
不相容的命令列選項
在您開始前
在您執行 ScanState 命令之前,請注意下列各項:
若要確保移轉所有作業系統設定,在大部分的情況下,您必須使用具有系統管理認證的帳戶以系統管理員模式執行 ScanState 命令。
如果您加密移轉存放區,將需要輸入加密金鑰或包含加密金鑰的檔案路徑。請務必記下金鑰或金鑰檔案位置,因為此資訊不會保存在移轉存放區的任何地方。當您執行 LoadState 命令為移轉存放區解密時,或需要執行修復公用程式時,就需要這項資訊。金鑰或金鑰檔案不正確或遺失,都會產生錯誤訊息。
如需執行 ScanState 命令時的軟體需求相關資訊,請參閱USMT 需求。
重要
Windows XP 和 Windows Vista® 僅可作為來源電腦上的作業系統。
除非另有說明,您只可以在命令列上使用每個選項一次。
您現在不需要具有網域控制站存取的來源電腦,就可以收集網域帳戶。不需要使用額外的設定,就能使用此功能。
不相容的命令列選項表格會列出您可以一起使用的選項,以及不相容的命令列選項。
儲存移轉存放區的目錄位置會從掃描中排除。例如,如果您將移轉存放區儲存在 D 磁碟機的根目錄,D 磁碟機及其所有子目錄都會從掃描中排除。
語法
本節會說明 ScanState 命令列選項的語法與使用方式。這些選項可以透過任意順序加以指定。如果選項中包含參數,可以使用冒號或空格分隔符號。
ScanState 命令的語法為:
scanstate [StorePath] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|help]
例如:
若要在目前的目錄中建立 Config.xml 檔案,請使用:
scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13
若要使用 Config.xml 檔案和預設移轉 .xml 檔案建立加密的存放區,請使用:
scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"
儲存選項
命令列選項 | 說明 |
---|---|
StorePath |
指出將儲存檔案與設定的資料夾。請注意,StorePath 不可以是 c:\。您必須在 ScanState 命令中指定 StorePath 選項,但是使用 /genconfig 選項時除外。您不可指定多個 StorePath 位置。 |
/o |
在覆寫移轉存放區或 Config.xml 檔案中的任何現有資料時需要此項。在未指定的情況下,如果移轉存放區已經包含資料,ScanState 命令會失敗。您不可以在命令列上多次使用此選項。 |
/vsc |
此選項可啟用磁碟區陰影複製服務,以便移轉已鎖定或使用中的檔案。此命令列選項會消除 <ErrorControl> 區段一般會遇到的大多數檔案鎖定錯誤。 此選項僅可用於 ScanState 可執行檔,無法與 /hardlink 選項結合使用。 |
/hardlink |
能夠在指定的位置建立永久連結移轉存放區。/nocompress 選項必須與 /hardlink 選項一起指定。 |
/encrypt [{/key:<KeyString> | /keyfile:<file>]} |
使用指定的金鑰加密存放區。預設會停用加密。使用此選項時,您必須以下列其中一個方式指定加密金鑰:
我們建議 KeyString 的長度至少為 8 個字元,但是不得超過 256 個字元。/key 和 /keyfile 選項不可用於相同的命令列上。/encrypt 和 /nocompress 選項不可用於相同的命令列上。 > [!IMPORTANT] > 使用此選項時請特別小心,因為任何可以存取 ScanState 命令列指令碼的人也都將可以存取加密金鑰。 >下列範例顯示 ScanState 命令和 /key 選項:
|
/encrypt:<EncryptionStrength> |
/encrypt 選項可接受命令列參數,以定義要用於加密移轉存放區的加密強度。如需所支援加密演算法的相關資訊,請參閱移轉存放區加密。 |
/nocompress |
停用資料壓縮並將檔案儲存到 StorePath\USMT 下名為 "File" 的隱藏資料夾。預設會啟用壓縮。將 /nocompress 選項與 /hardlink 選項合併使用會產生永久連結移轉存放區。您可以使用未壓縮的存放區來檢視 USMT 所儲存的內容、疑難排解問題,或是對檔案執行防毒公用程式。您應該只在測試環境中使用此選項,因為我們建議您在實際移轉時使用已壓縮的存放區,除非您將 /nocompress 選項與 /hardlink 選項合併使用。 /nocompress 和 /encrypt 選項無法在命令列上的一個陳述式中一起使用。不過,如果您確實選擇要移轉未壓縮的存放區,LoadState 命令就會將每個檔案直接從存放區移轉到目的電腦上的正確位置,而不需要暫存位置。 例如:
|
在離線 Windows 系統上執行 ScanState 命令
您可以在 Windows PE 中執行 ScanState 命令。此外,USMT 支援從 Windows.old 目錄內含的先前 Windows 安裝進行移轉。當您在 Windows PE 中執行 ScanState 命令時,離線目錄可能為 Windows 目錄,而當您在 Windows 中執行 ScanState 命令時,離線目錄則可能為 Windows.old 目錄。
在離線 Windows 映像上執行 ScanState 命令有幾個好處,包括:
改善效能。
因為 Windows PE 是精簡型作業系統,所以執行的服務比較少。在此環境中,ScanState 命令比較容易存取本機硬體資源,而讓 ScanState 能夠更迅速地執行移轉作業。
簡化端點對端點部署程序。
從 Windows.old 移轉資料可讓移轉程序在安裝新的作業系統之後發生,進而簡化端點對端點部署程序。
改善移轉的成功率。
移轉成功率會提高,因為檔案在離線狀態不會為了進行編輯而鎖定,而且 Windows PE 提供了離線 Windows 檔案系統中檔案的系統管理員存取權,因而不需要線上系統的系統管理員等級存取權。
能夠復原無法開機的電腦。
有可能從無法開機的電腦復原和移轉資料。
離線移轉選項
命令列選項 | 定義 |
---|---|
/offline: "path to an offline.xml file" |
此選項用於定義離線 .xml 檔案的路徑,而該檔案會指定其他離線移轉選項,例如,離線 Windows 目錄或是移轉中所需的任何網域或資料夾重新導向。 |
/offlinewindir: "path to a Windows directory" |
此選項可指定 ScanState 命令從中收集使用者狀態的離線 Windows 目錄。當您在 Windows 中執行 ScanState 命令時,離線目錄可能為 Windows.old,而當您在 Windows PE 中執行 ScanState 命令時,離線目錄則可能為 Windows 目錄。 |
/offlinewinold: "Windows.old directory" |
此命令列選項會啟用離線移轉模式,並且從指定的位置啟動移轉。只適用於 Windows.old 移轉案例,在這些案例中,會在 Windows.old 目錄進行移轉。 |
移轉規則選項
USMT 會提供下列選項,讓您指定想要移轉的檔案。
命令列選項 | 說明 | ||||||||
---|---|---|---|---|---|---|---|---|---|
/i:[Path\]FileName |
(包含) 指定 .xml 檔案,其中包含會定義所要移轉的使用者、應用程式或系統狀態的規則。您可以多次指定此選項,以包含所有 .xml 檔案 (MigApp.xml、MigDocs.xml 和任何建立的自訂 .xml 檔案)。Path 可以是相對或完整路徑。如果未指定 Path 變數,則 FileName 必須位於目前的目錄中。如需要指定哪些檔案的詳細資訊,請參閱常見問題集主題中的<XML 檔案>一節。 |
||||||||
/genconfig:[Path\]FileName |
(產生 Config.xml) 產生選用 Config.xml 檔案,但不會建立移轉存放區。若要確保此檔案包含每一個可以移轉的元件、應用程式和設定,您應該在來源電腦 (含有將移轉到目的電腦上的所有元件、應用程式和設定) 上建立此檔案。此外,當您指定此選項時,應該使用 /i 選項指定其他移轉 .xml 檔案。 建立此檔案之後,您需要使用 ScanState 命令搭配 /config 選項,以利用此檔案。 可以與此選項一起指定的選項僅限於 /i、/v 以及 /l 選項。您不能指定 StorePath,因為 /genconfig 選項不會建立存放區。Path 可以是相對或完整路徑。如果未指定 Path 變數,則會在目前的目錄中建立 FileName。 範例:
|
||||||||
/config:[Path\]FileName |
指定 ScanState 命令應用於建立存放區的 Config.xml 檔案。您不可以在命令列上多次使用此選項。Path 可以是相對或完整路徑。如果未指定 Path 變數,則 FileName 必須位於目前的目錄中。 下列範例會使用 Config.xml 檔案、MigDocs.xml 和 MigApp.xml 檔案建立存放區:
下列範例會使用 Config.xml、MigDocs.xml 以及 MigApp.xml 檔案,將檔案與設定移轉到目的電腦:
|
||||||||
/auto: path to script files |
此選項可讓您指定預設 .xml 檔案的位置,然後開始進行移轉。如果未指定路徑,USMT 會參考 USMT 二進位檔所在的目錄。/auto 選項的效用與使用下列選項相同:/i:MigDocs.xml/i:MigApp.xml /v:5。 |
||||||||
/genmigxml: 檔案路徑 |
此選項會指定 ScanState 命令應使用文件尋找工具來建立及匯出 .xml 檔案,以定義如何在執行 ScanState 命令的電腦上移轉所有檔案。 |
||||||||
/localonly |
不論您在命令列上指定的 .xml 檔案中的規則為何,都只會移轉儲存在本機電腦上的檔案。當您想要排除來源電腦上卸除式磁碟機 (如 USB 快閃磁碟機 (UFD)、部分外部硬碟等) 的資料,以及當來源電腦有對應的網路磁碟機時,您都應該使用此選項。如果未指定 /localonly 選項,則 ScanState 命令會將檔案從這些卸除式磁碟機或網路磁碟機複製到存放區中。 /localonly 會將作業系統不認為是固定磁碟機的所有項目排除。在某些情況下,大型外接式硬碟會被視為固定磁碟機。您可以使用 custom.xml 檔案,在移轉時明確排除這些磁碟機。如需如何排除特定磁碟機上所有檔案的詳細資訊,請參閱排除檔案與設定。 /localonly 命令列選項會如下表所示,在移轉中包含或排除資料:
|
監視選項
USMT 提供數個選項,可讓您用來分析移轉期間發生的問題。
備註 |
---|
預設會建立 ScanState 記錄,但是您可以透過 /l 選項指定此記錄的名稱和位置。 |
命令列選項 | 說明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/listfiles:<FileName> |
您可以使用 /listfiles 命令列選項搭配 ScanState 命令,以產生會列出移轉中內含之所有檔案的文字檔。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/l:[Path\]FileName |
指定 ScanState 記錄的位置與名稱。 您不可在 StorePath 中儲存任何記錄檔。Path 可以是相對或完整路徑。如果未指定 Path 變數,則會在目前的目錄中建立記錄。您可以使用 /v 選項來調整輸出量。 如果從共用的網路資源執行 ScanState 或 LoadState 命令,您必須指定此選項,否則 USMT 會因下列錯誤而失敗:「USMT 無法建立記錄檔」。若要修正此問題,請使用 /l:scan.log 命令。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) 在 ScanState 記錄檔中啟用詳細資訊輸出。預設值為 0。 您可以將 VerbosityLevel 設為下列其中一個等級:
使用者選項根據預設,會移轉所有使用者。指定要包含及排除哪些使用者的唯一方式為使用下列選項。您無法在移轉 .xml 檔案或使用 Config.xml 檔案來排除使用者。如需詳細資訊,請參閱識別使用者和移轉使用者帳戶。
如何使用 /ui 和 /ue下列範例同時適用於 /ui 和 /ue 選項。您可以使用 /ui 選項取代 /ue 選項,來包含 (而非排除) 指定的使用者。
一起使用選項您可以將 /uel、/ue 和 /ui 選項一起使用,僅移轉您要移轉的使用者。 **/ui 選項的優先順序高於 /ue 和 /uel 選項。**如果使用 /ui 選項指定要包含某個使用者,同時也使用 /ue 或 /uel 選項指定排除該使用者,則移轉時會包含該使用者。例如,如果指定 **/uel 選項的優先順序高於 /ue 選項。**如果使用者已經在 /uel 選項設定的指定時間間隔內登入,則即使使用 /ue 選項排除,還是會移轉該使用者的設定檔。例如,如果您指定
加密的檔案選項您可以使用下列選項移轉加密的檔案。在所有情況下,除非您指定了 /efs 選項,否則只要找到加密的檔案,USMT 預設都會發生失敗。若要移轉加密的檔案,您必須變更預設行為。 如需詳細資訊,請參閱移轉 EFS 檔案和憑證。
注意 移轉加密的檔案時,請特別小心。如果憑證並未跟著加密的檔案一起移轉,使用者便無法在移轉之後存取該檔案。
不相容的命令列選項下表指出與 ScanState 命令不相容的命令列選項。如果特定組合的表格項目為空白,則為相容選項而且可以一起使用。X 符號表示選項不相容。例如,您無法將 /nocompress 選項與 /encrypt 選項搭配使用。
另請參閱其他資源 |