自訂配置檔redirections.xml

發行項
04/05/2024

教學課程：建立和實作redirections.xml
常見問題：重新導向或redirections.xml

自訂配置檔重新導向是使用位於使用者配置檔容器內的 XML 檔案（redirections.xml）來設定。 FSLogix 不會建立redirections.xml檔案。 redirections.xml檔案會從來源位置複製到使用者的配置檔容器。在大部分情況下，來源位置是遠端檔案共享，使用者可以從中複製和複製到其配置檔容器。本檔提供redirection.xml檔案的詳細數據，以及如何為您的特定使用案例實作。

使用redirections.xml的時機

使用者配置檔中的數據並非設計為要移除或排除。除非您對配置檔或應用程式中的數據有非常了解，否則請勿將其從容器中排除。

在配置檔案容器中包含和排除檔案和資料夾

若要在使用者配置檔容器中包含/排除檔案和/或資料夾，您必須建立名為 redirections.xml 的檔案。此檔案會定義要從使用者配置檔容器複製或排除的專案。 XML 檔案會在使用者登入和註銷虛擬機期間進行處理。當使用者登入虛擬機時，對 XML 檔案所做的任何變更，在註銷和登入之前都不會生效。

拿掉或重新命名來源位置的 XML 檔案並不會移除或重新命名給使用者。如果需要移除自定義重新導向，請清除 XML 檔案內容，並將它儲存至來源位置。在下一次登入時，更新的檔案將會複製到使用者配置檔容器。

注意

redirections.xml僅適用於搭配配置檔容器使用，且在使用 ODFC 容器時沒有作用。

redirections.xml的位置

XML 檔案有兩個（2）個位置。來源位置，通常是遠端檔案共用，以及使用者配置檔容器中的位置。

來源檔案位置

XML 檔案可以集中放置，以便輕鬆散發。 RedirXMLSourceFolder 設定會指定用戶端在登入時檢查的位置，以查看是否有redirections.xml檔案。如果找到一個，而且它與現有的檔案不同，則會複製到使用者的配置檔容器。然後處理內容。

儲存在中央位置 時（例如，儲存使用者配置檔容器的根目錄或子目錄），請確定使用者只有 XML 檔案的讀取許可權。

注意

只指定redirections.xml檔案的路徑，請勿指定檔名。

使用者的配置檔位置

從來源位置複製時，redirections.xml檔案位於下列位置：

%userprofile%\AppData\Local\FSLogix\redirections.xml （在使用者設定檔案容器內）

重要

如果移除redirections.xml中的任何專案或專案，則內容或資料夾會保留在 VHD（x）中。 redirections.xml中新增的任何項目都會放在 [local_]%username% 資料夾中，但 VHD（x）中已經存在的專案不會從 VHD（x）中移除。

XML 檔案內容

redirections.xml檔案是由 XML 宣告、三個（3）個元素和兩個（2）個屬性所組成。 XML 宣告是標準的，不應該變更。

元素和屬性

FrxProfileFolderRedirection：這是 XML 檔案中的第一個專案，應該只使用一次。
- ExcludeCommonFolders：這個屬性會定義哪些已知資料夾應該從使用者配置檔容器重新導向。此屬性會採用位掩碼值，告知 FSLogix 要排除的資料夾組合。為要排除的所有資料夾加起來值。例如，值為 7 會排除 [連絡人]、[桌面] 和 [檔] 資料夾。
  - 1：聯繫人資料夾
  - 2：桌面資料夾
  - 4:D ocuments資料夾
  - 8：下載資料夾
  - 16：鏈接資料夾
  - 32：音樂資料夾
  - 64：圖片和影片資料夾
  - 128：涉及低完整性層級程序的資料夾，例如AppData\LocalLow
- 排除：此元素用於巢狀Exclude專案的集合。
  - Exclude：這個專案描述要從使用者容器中排除的單一位置。這些元素中使用的路徑必須存在於使用者的配置檔路徑中（%userprofile%）。路徑不得包含C:\Users\%username%路徑的一部分。
    - 複製：此屬性會定義 FSLogix 在重新導向期間如何處理檔案和資料夾。屬性可以從與使用 0 值相同的元素中省略。
      - 0：在 local_%username% 目錄中建立空的資料夾。作業期間不會複製任何檔案。複製 0 是用來減少使用者配置檔內容的最常見值。不會移除位於該位置之容器中的任何數據。用戶會話期間只會在 local_%username% 資料夾中建立未來的數據，並在註銷時移除。
      - 1：在 local_%username% 目錄中建立資料夾，並將檔案從指定的位置複製。容器中的數據會複製到資料夾， local_%username% 而且任何新數據也會寫入該路徑。在使用者註銷 local_%username% 時，會移除，並遺失任何新的數據。第^N次登入一律會將數據從容器local_%username%複製到資料夾。
      - 2：在目錄中建立資料夾local_%username%，並將檔案複製到指定的位置。會在 中local_%username%建立新的 （空白）資料夾。在使用者的工作階段期間，數據會寫入該路徑。註銷時，數據會複製到容器中。 除非由Microsoft支持工程師指示，否則請勿使用此值。
      - 3：在目錄中建立資料夾 local_%username% ，並將檔案從和 複製到 指定的位置。這個值結合 1 和 2 的效果。現有的數據會從容器複製並複製到 local_%username% 資料夾中。新的數據會寫入路徑， local_%username% 並在註銷時，所有數據都會複製到容器中。
- 包括：此元素用於巢狀 Include 專案的集合。
  - Include：此元素是用來確保排除路徑的子目錄保留在容器中。這些元素中不會使用 COPY 值。這些元素中使用的路徑必須存在於使用者的配置檔路徑中（%userprofile%）。路徑不得包含C:\Users\%username%路徑的一部分。
  注意
  - 資料夾或資料必須存在於要包含在容器中的配置檔中。例如， 使用 FSLogix 搭配 include 語句的新 配置檔可能沒有針對特定路徑建立的所有資料夾結構，因為使用者從未在其 FSLogix 配置檔容器的內容中使用應用程式。
  - 包含資料夾路徑 的父資料夾必須 存在於容器中，讓 include 正常運作。
  - XML 檔案將接受任意數目的 Include 和 Exclude 專案。

範例redirections.xml

重要

這個範例示範如何使用專案。請遵循建立和實作真實世界 XML 實作的redirections.xml教學課程。驚嘆號和包含可能會產生非預期的後果，而且必須小心建立。

排除已知資料夾（連絡人、連結和音樂）
排除 Contoso Sales App，將容器 local_%username% 中的任何數據複製到資料夾，並在註銷時回到容器。具有複製的 exclude 語句會將數據的 I/O 移至 本機磁碟，而不是容器¹。
排除沒有複製作業的 Microsoft Edge 資料夾（登出時會移除所有資料）。
將資料夾包含在排除Microsoft Edge 資料夾內。User Data

^{1 仍需要 I/O 才能複製數據。}

<?xml version="1.0"  encoding="UTF-8"?>
<FrxProfileFolderRedirection ExcludeCommonFolders="49">
<Excludes>
<Exclude Copy="3">AppData\Roaming\Contoso\ContosoSalesApp</Exclude>
<Exclude Copy="0">AppData\Local\Microsoft\Edge</Exclude>
</Excludes>
<Includes>
<Include>AppData\Local\Microsoft\Edge\User Data</Include>
</Includes>
</FrxProfileFolderRedirection>

注意

在 Windows 8 和更新版本上，低完整性層級進程所涉及的資料夾一律會重新導向至 local_%username% 目錄。
如果在與 Include 元素中Exclude指定了相同的資料夾，Exclude則會優先使用。
若要列出 FSLogix 所放置的重新導向，請使用 frx命令行公用程式。

下一步

redirections.xml常見問題

共用方式為