瞭解移轉 XML 檔案

發行項
03/19/2024
適用於:

✅ Windows 11, ✅ Windows 10

您可以使用 XML 檔案來修改基本使用者狀態移轉工具 (USMT) 移轉的行為。這些檔案提供 USMT 工具應該收集及套用檔案和設定的位置和方式指示。 USMT 包含三個 XML 檔案，可用來自定義基本移轉： MigDocs.xml 和 MigUser.xml 檔案，可修改在來源計算機上探索檔案的方式，以及 MigApps.xml 檔案，這是移轉支援的應用程式設定所需的檔案。您可以建立和編輯自定義 XML 檔案和 Config.xml 檔案，以進一步自定義移轉。

本文提供預設和自定義移轉 XML 檔案的概觀，並包含建立和編輯自定義版本檔案的 MigDocs.xml 指導方針。檔案 MigDocs.xml 會使用 USMT 中可用的新 GenerateDocPatterns 函式，自動尋找來源電腦上的使用者檔。

Config.xml 檔案概觀

檔案Config.xml是由 ScanState 工具的選項所/genconfig建立的組態檔。它可用來修改 USMT 移轉的作業系統元件。檔案 Config.xml 可以與其他 XML 檔案搭配使用，例如在下列範例中：

ScanState.exe /i:migapps.xml /i:MigDocs.xml /genconfig:c:\myFolder\Config.xml

以這種方式使用時， Config.xml 檔案會嚴密控制移轉的各個層面，包括使用者配置檔、數據和設定，而不需要修改或建立其他 XML 檔案。如需檔案的 Config.xml 詳細資訊，請參閱自定義 USMT XML 檔案和 Config.xml 檔。

注意

修改檔案中的 Config.xml XML 元素時，請將專案上的移轉屬性設定為 no ，而不是從檔案中刪除專案。如果刪除元素而不是設定屬性，其他 XML 檔案中的規則仍然可以移轉元件。

MigApp.xml 檔案概觀

MigApp.xml隨 USMT 一起安裝的檔案包含移轉 USMT Migrate？中所列應用程式設定的指示。若要移轉應用程式設定， MigApp.xml 使用 ScanState 和 LoadState 工具時，必須使用 /i 選項來包含檔案。和 MigDocs.xmlMigUser.xml 檔案不會移轉應用程式設定。您可以建立自訂 XML 檔案來包含其他應用程式。如需詳細資訊，請參閱自定義 USMT XML 檔案。

重要

檔案 MigApps.xml 只會偵測並移轉連結至 Microsoft Office Outlook 的 .pst 檔案。如需移轉未連結至 Outlook 之 .pst 檔案的詳細資訊，請參閱自定義 XML 檔案版本的移轉規則範例。

MigDocs.xml 檔案概觀

檔案 MigDocs.xml 會使用新的 GenerateDocPatterns 協助程式函式，根據檔案的位置，建立 USMT 從來源電腦移轉檔案的指示。與 MigDocs.xml 不使用 XML 指示的 USMT 相比，此檔案可以與 ScanState 和 LoadState 工具搭配使用，以執行更具目標的移轉。

預設 MigDocs.xml 檔案會移轉下列資料：

磁碟驅動器根目錄上的所有檔案，但、、或 %USERS%除外%WINDIR%。 %PROGRAMDATA%%PROGRAMFILES%
所有固定磁碟驅動器根目錄中的所有資料夾。例如：c:\data_mail\*[*]。
[設定檔] 資料夾根目錄中的所有檔案，但系統配置檔中的檔案除外。例如：c:\users\name[mail.pst]。
[設定檔] 資料夾根目錄中的所有資料夾，但系統設定檔資料夾除外。例如：c:\users\name\new folder\*[*]。
標準共享資料夾：
- CSIDL_COMMON_DESKTOPDIRECTORY
- CSIDL_COMMON_FAVORITES
- CSIDL_COMMON_DOCUMENTS
- CSIDL_COMMON_MUSIC
- CSIDL_COMMON_PICTURES
- CSIDL_COMMON_VIDEO
- FOLDERID_PublicDownloads
每個使用者的標準使用者設定資料夾：
- CSIDL_MYDOCUMENTS
- CSIDL_MYPICTURES
- FOLDERID_OriginalImages
- CSIDL_MYMUSIC
- CSIDL_MYVIDEO
- CSIDL_FAVORITES
- CSIDL_DESKTOP
- CSIDL_QUICKLAUNCH
- FOLDERID_Contacts
- FOLDERID_Libraries
- FOLDERID_Downloads
- FOLDERID_SavedGames
- FOLDERID_RecordedTV

預設 MigDocs.xml 檔案不會移轉下列資料：

同時標記隱藏和系統屬性的檔案。
卸載式磁碟驅動器上的檔案和資料夾。
來自 %WINDIR%、%PROGRAMDATA% 和 %PROGRAMFILES% 資料夾的數據。
包含已安裝應用程式的資料夾。

選項 /genmigxml 可以與 ScanState 工具搭配使用，以檢閱和修改要移轉的檔案。

MigUser.xml 檔案概觀

此 MigUser.xml 檔案包含 USMT 根據擴展名移轉使用者檔案的指示。與 MigUser.xml 不使用 XML 指示的 USMT 相比，此檔案可以與 ScanState 和 LoadState 工具搭配使用，以執行更具目標的移轉。檔案 MigUser.xml 會收集標準使用者配置檔資料夾中的所有檔案，以及計算機上具有指定擴展名的任何檔案。

預設 MigUser.xml 檔案會移轉下列資料：

標準使用者設定檔資料夾中的所有檔案，其描述如下：
- CSIDL_MYVIDEO
- CSIDL_MYMUSIC
- CSIDL_DESKTOP
- CSIDL_STARTMENU
- CSIDL_PERSONAL
- CSIDL_MYPICTURES
- CSIDL_FAVORITES
- CSIDL_QUICK啟動
具有下列擴展名的檔案：

.accdb, .ch3, .csv, .dif, .doc*, .dot*, .dqy, .iqy, .mcw, .mdb*, .mpp, .one*, .oqy, .or6, .pot*, .ppa, .pps*, .ppt*, .pre, .pst, .pub, .qdf, .qel, .qph, .qsd, .rqy, .rtf, .scd, .sh3, .slk, .txt, .vl*, .vsd, .wk*, .wpd, .wps, .wq1, .wri, .xl*, .xla, .xlb, .xls*

注意

星號 () * 代表零個或多個字元。

注意

默認不會移轉 Microsoft Office 應用程式可以使用的 OpenDocument 擴*.odt*.odp充 (、 *.ods 、) 。

預設 MigUser.xml 檔案不會移轉下列資料：

同時以 Hidden 和 System 屬性標記的檔案。
卸載式磁碟驅動器上的檔案和資料夾。
、%WINDIR%、 %PROGRAMFILES%%PROGRAMDATA% 資料夾中的數據。
使用者配置檔外資料夾中檔案的 ACLS。

您可以 MigUser.xml 複製檔案，然後修改複本以包含或排除標準使用者配置資料夾和擴展名。如果已知需要從來源計算機移轉之檔案的所有擴展名，請使用 MigUser.xml 檔案來移動所有相關數據，而不論檔案的位置為何。不過，在所有需要移轉至 MigUser.xml 檔案的擴展名中新增可能會導致移轉的檔案數目超出預期。例如，如果移轉所有 .jpg 檔案，它也可以從安裝在來源電腦上的舊版應用程式移轉圖像檔，例如縮圖和標誌。

注意

檔案內 MigUser.xml 規則中包含的每個擴展名都會增加 ScanState 工具收集移轉檔案所需的時間量。如果移轉超過 300 個檔案類型，移轉體驗可能會變慢。如需組織數據移轉之其他方式的詳細資訊，請參閱本文的使用多個 XML 檔案一節。

使用多個 XML 檔案

多個 XML 檔案可以與 ScanState 和 LoadState 工具搭配使用。 USMT 隨附或產生的每個預設 XML 檔案都會針對移轉的特定元件進行設定。自訂 XML 檔案也可用來使用更多移轉規則來補充這些預設檔案。

XML 移轉檔案	變更下列元件：
Config.xml 檔案	操作系統元件，例如桌面桌布和背景主題。 `Config.xml`也可以擴充以包含一些應用程式和檔設定，方法是使用其他預設 XML 檔案產生`Config.xml`檔案。如需詳細資訊，請參閱自定義 USMT XML 檔案和 Config.xml 檔。
MigApps.xml 檔案	應用程式設定。
MigUser.xml 或 MigDocs.xml 檔案	用戶檔案和配置檔設定。
自訂 XML 檔案	應用程式設定、使用者配置檔設定或用戶檔案，超出其他 XML 檔案中包含的規則。

例如，所有 XML 移轉檔案類型都可以用於單一移轉，如下列範例所示：

ScanState.exe <store> /config:c:\myFolder\Config.xml /i:migapps.xml /i:MigDocs.xml /i:CustomRules.xml

移轉使用者檔案的 XML 規則

重要

和 MigUser.xmlMigDocs.xml 檔案不應該在同一個命令中一起使用。使用這兩個 XML 檔案可能會導致某些已移轉的檔案重複。在每個 XML 檔案中提供衝突的目標位置指示時，可能會發生某些已移轉檔案的重複。目標檔案會在移轉期間儲存一次，但每個 XML 檔案都會將檔案套用至目的地電腦上的不同位置。

如果數據集未知，或許多檔案儲存在標準使用者配置檔資料夾之外， MigDocs.xml 則是比 MigUser.xml 檔案更好的選擇，因為 MigDocs.xml 檔案會收集更廣泛的數據範圍。檔案 MigDocs.xml 會根據位置移轉數據的資料夾。檔案 MigUser.xml 只會移轉具有指定擴展名的檔案。

若要進一步控制移轉，請建立自定義 XML 檔案。如需建立自定義 XML 檔案的詳細資訊，請參閱建立和編輯自定義 XML 檔案。

建立和編輯自定義 XML 檔案

命令 /genmigxml 行選項可用來判斷移轉中包含哪些檔案。選項 /genmigxml 會在指定的位置建立檔案。然後可以檢閱檔案中的 XML 規則，並在必要時進行修改。

注意

如果重新安裝 USMT，則會覆寫預設的移轉 XML 檔案，並遺失對這些檔案所做的任何自定義。請考慮為自定義移轉規則建立個別的 XML 檔案，並將它們儲存在安全的位置。

若要產生來源電腦的 XML 移轉規則檔案：

選取 [啟動>所有程式配件]>
以滑鼠右鍵按兩下 [命令提示字元]，然後選取 [ 執行身分]。
選取具有系統管理員許可權的帳戶、提供密碼，然後選取 [ 確定]。
在命令提示字元中，輸入：
```
cd /d <USMTpath>
ScanState.exe /genmigxml: <filepath.xml>
```
其中：
- <USMTpath> - 儲存之 USMT 檔案和工具的來源電腦上的位置。
- <>filepath.xml - 可儲存報表之檔案的完整路徑。
例如，輸入：
```
cd /d c:\USMT
ScanState.exe /genmigxml:"C:\Users\USMT Tester\Desktop\genMig.xml"
```

GenerateDocPatterns 函式

檔案 MigDocs.xml 會呼叫 GenerateDocPatterns 函式，其接受三個布爾值。您可以變更設定，以修改檔案產生 XML 規則以進行移轉的方式 MigDocs.xml 。

ScanProgramFiles：只有在系統內容中呼叫函式時， GenerateDocPatterns 這個自變數才有效。這個自變數會判斷是否要掃描 Program Files 目錄，以收集已知應用程式的已註冊擴展名。

默認值：False

例如，當設定為 TRUE 時，函式會在 Microsoft Office 目錄下探索及移轉 .doc 檔案，因為 .doc 是向 Microsoft Office 應用程式註冊的擴展名。函 GenerateDocPatterns 式會為 .doc 檔案產生此包含模式：

<pattern type="File">C:\Program Files\Microsoft Office[.doc]</pattern>

如果內含資料夾的子資料夾包含已安裝的應用程式， ScanProgramFiles 也會建立子資料夾的排除規則。應用程式資料夾下的所有資料夾都會遞迴掃描，以尋找已註冊的擴展名。
IncludePatterns：這個自變數會決定要在 XML 中產生排除或包含模式。當此自變數設定為 TRUE時， GenerateDocPatterns 函式會產生 include 模式，而且必須將函式新增至專案下 <include> 方。將這個自變數變更為 FALSE 會產生排除模式，而且必須將函式新增至專案底下 <exclude> 。

默認值：True
SystemDrive：這個自變數會決定要為所有固定磁碟驅動器產生模式，還是只針對系統磁碟驅動器產生模式。將此自變數變更為 TRUE 會限制系統磁碟驅動器的所有模式。

默認值：False

使用：

MigXmlHelper.GenerateDocPatterns ("<ScanProgramFiles>", "<IncludePatterns>", "<SystemDrive>")

若要僅針對系統磁碟驅動器建立包含數據模式：

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","TRUE","TRUE")</script>
     </objectSet>
</include>

若要建立包含規則，以從 %PROGRAMFILES% 目錄收集已註冊擴充功能的檔案：

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("TRUE","TRUE","FALSE")</script>
     </objectSet>
</include>

若要建立排除數據模式：

<exclude filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <script>MigXmlHelper.GenerateDocPatterns ("FALSE","FALSE","FALSE")</script>
     </objectSet>
</exclude>

了解系統和用戶內容

移轉 XML 檔案包含兩<個具有不同內容設定的元件>元素：

系統內容適用於電腦上未儲存在 User Profiles 目錄中的檔案。
用戶內容會套用至個別使用者特定的檔案。

系統內容

系統內容包含使用者配置檔目錄外部數據的規則。例如，在檔案的系統內容中 MigDocs.xml 呼叫時， GenerateDocPatterns 函式會為所有常見的殼層資料夾、硬碟根目錄中的檔案，以及位於硬碟根目錄的資料夾建立模式。包含下列資料夾：

CSIDL_COMMON_DESKTOPDIRECTORY
CSIDL_COMMON_FAVORITES
CSIDL_COMMON_DOCUMENTS
CSIDL_COMMON_MUSIC
CSIDL_COMMON_PICTURES
CSIDL_COMMON_VIDEO
FOLDERID_PublicDownloads

用戶內容

用戶內容包含使用者配置檔目錄中的數據規則。在檔案的使用者內容中 MigDocs.xml 呼叫時， GenerateDocPatterns 函式會為位於配置檔根目錄的所有使用者殼層資料夾、位於配置檔根目錄的檔案，以及位於配置檔根目錄的資料夾建立模式。包含下列資料夾：

CSIDL_MYDOCUMENTS
CSIDL_MYPICTURES
FOLDERID_OriginalImages
CSIDL_MYMUSIC
CSIDL_MYVIDEO
CSIDL_FAVORITES
CSIDL_DESKTOP
CSIDL_QUICKLAUNCH
FOLDERID_Contacts
FOLDERID_Libraries
FOLDERID_Downloads
FOLDERID_SavedGames
FOLDERID_RecordedTV

注意

指派用戶內容的元件中所包含的規則會針對計算機上的每個使用者配置檔執行。檔案掃描多次的 MigDocs.xml 檔案只會複製到移轉存放區一次。不過，用戶內容中的大量規則可能會使移轉速度變慢。適用時，請使用系統內容。

自訂 XML 檔案版本的範例移轉規則

提示

如需 USMT 中自定義 XML 檔案的最佳做法和需求，請參閱自定義 USMT XML 檔案和一般慣例。

排除規則使用範例

在下列範例中，來源計算機在名為的目錄中具有名為的 new text documentnew folder.txt 檔案。默認 MigDocs.xml 行為會移轉新的文本 document.txt 文件和目錄中 new folder 包含的所有檔案。函式產生的規則如下：

規則	語法
規則 1	`<pattern type="File">d:\new folder[new text document.txt]</pattern>`
規則 2	`<pattern type="File">d:\new folder[]</pattern>`

若要排除中的新文本 document.txt 檔和任何 .txt 檔案 new folder，可以進行下列修改：

範例 1：排除資料夾中的所有 .txt 檔案

若要排除規則 1，檔名必須完全相符。不過，對於規則 2，可以使用擴展名來建立模式來排除檔案。

<exclude>
     <objectSet>
        <pattern type="File">D:\Newfolder\[new text document.txt]</pattern>
         <pattern type="File">D:\New folder\*[*.txt]</pattern>
     </objectSet>
</exclude>

範例 2：使用無條件的Exclude 元素，提供規則優先順序高於 include 規則

如果檔案的檔名或位置未知，但已知擴展名， GenerateDrivePatterns 則可以使用函式。不過，規則比檔案產生的 MigDocs.xml 預設 include 規則更不明確，因此沒有優先順序。無 <條件Exclude> 元素必須用來提供此規則優先順序，而不是預設 include 規則。如需 XML 移轉規則優先順序的詳細資訊，請參閱衝突和優先順序。

<unconditionalExclude>
     <objectSet>
        <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
     </objectSet>
</unconditionalExclude>

範例 3：使用 UserandSystem 內容元件在這兩個內容中執行規則

若要將 <無條件Exclude> 元素同時套用至系統和用戶內容，可以使用 UserandSystem 內容建立第三個元件。此元件中的規則會在這兩個內容中執行。

<component type="Documents" context="UserandSystem">
   <displayName>MigDocExcludes</displayName>
   <role role="Data">
     <rules>
       <unconditionalExclude>
         <objectSet>
                <script>MigXmlHelper.GenerateDrivePatterns ("*[*.txt]", "Fixed")</script>
         </objectSet>
       </unconditionalExclude>
     </rules>
   </role>
</component>

如需可在自定義移轉 XML 檔案中使用的排除規則範例，請參閱排除檔案和設定。

包含規則使用範例

應用程式資料目錄是必須為其新增 include 規則的最常見位置。函 GenerateDocPatterns 式預設會排除此位置。如果組織使用將重要資料儲存至此位置的應用程式，則可以建立包含規則來移轉數據。例如， .pst 檔案的預設位置是： %CSIDL_LOCAL_APPDATA%\Microsoft\Outlook。檔案 MigApp.xml 包含移轉規則，只移動連結至 Microsoft Outlook 的 .pst 檔案。若要包含未連結的 .pst 檔案，可以進行下列修改：

範例 1：在已知的使用者資料夾中包含擴展名

此規則包含位於預設位置但未連結至 Microsoft Outlook 的 .pst 檔案。使用用戶內容，為計算機上的每個使用者執行此規則。

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_LOCAL_APPDATA%\Microsoft\Outlook\*[*.pst]</pattern>
     </objectSet>
</include>

範例 2：在 Program Files 中包含擴展名

對於使用者配置檔外部的位置，例如 Program Files 資料夾，規則可以新增至系統內容元件。

<include filter='MigXmlHelper.IgnoreIrrelevantLinks()'>
     <objectSet>
        <pattern type="File">%CSIDL_PROGRAM_FILES%\*[*.pst]</pattern>
     </objectSet>
</include>

如需可在自定義移轉 XML 檔案中使用的包含規則的更多範例，請參閱包含檔案和設定。

提示

如需 XML 移轉規則優先順序的詳細資訊，請參閱衝突和優先順序。

後續步驟

移轉的其他規則可以包含在檔案或其他 XML 移轉檔案中 MigDocs.xml 。例如， <locationModify> 當檔案套用至目的地計算機時，元素可用來將檔案從收集到不同資料夾的資料夾中移動。

XML 架構 (MigXML.xsd) 檔可用來驗證自定義 XML 檔案的語法。如需詳細資訊，請參閱 USMT 資源。

排除檔案和設定。
包含檔案和設定。

共用方式為

瞭解移轉 XML 檔案

Config.xml 檔案概觀

MigApp.xml 檔案概觀

MigDocs.xml 檔案概觀

MigUser.xml 檔案概觀

使用多個 XML 檔案

移轉使用者檔案的 XML 規則

建立和編輯自定義 XML 檔案

GenerateDocPatterns 函式

了解系統和用戶內容

系統內容

用戶內容

自訂 XML 檔案版本的範例移轉規則

排除規則使用範例

範例 1：排除資料夾中的所有 .txt 檔案

範例 2：使用無條件的Exclude 元素，提供規則優先順序高於 include 規則

範例 3：使用 UserandSystem 內容元件在這兩個內容中執行規則

包含規則使用範例

範例 1：在已知的使用者資料夾中包含擴展名

範例 2：在 Program Files 中包含擴展名

後續步驟

意見反應

意見反應

其他資源

共用方式為

瞭解移轉 XML 檔案

Config.xml 檔案概觀

MigApp.xml 檔案概觀

MigDocs.xml 檔案概觀

MigUser.xml 檔案概觀

使用多個 XML 檔案

移轉使用者檔案的 XML 規則

建立和編輯自定義 XML 檔案

GenerateDocPatterns 函式

了解系統和用戶內容

系統內容

用戶內容

自訂 XML 檔案版本的範例移轉規則

排除規則使用範例

範例 1：排除資料夾中的所有 .txt 檔案

範例 2：使用無條件的Exclude 元素，提供規則優先順序高於 include 規則

範例 3：使用 UserandSystem 內容元件在這兩個內容中執行規則

包含規則使用範例

範例 1：在已知的使用者資料夾中包含擴展名

範例 2：在 Program Files 中包含擴展名

後續步驟

相關文章

意見反應

意見反應

其他資源