共用方式為


組態設定參考

本文概述適用於 FSLogix 的各種登錄設定,包括但不限於:

  • 應用程式服務
  • 配置檔案容器
  • ODFC 容器
  • 雲端快取
  • 記錄

預設設定

安裝 FSLogix 之後,安裝程式會建立一組基底的登錄機碼和值,以提供用於新增組態設定的架構。 FSLogix 不會在安裝期間建立 ANY 組態設定值名稱。 此頁面上所列的任何組態設定不需要建立或設定為 FSLogix,就會自動使用列出的預設值。

例如,此 RoamIdentity 設定的預設值為 『0』 。 FSLogix 不會將身分識別漫遊為預設行為,而且不需要系統管理員建立或新增登錄值名稱和值。 只有當想要變更設定的預設行為時,系統管理員才會建立或新增登錄值名稱和值。

基底登錄機碼和值名稱

  • [HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix]
    • \Apps
      • "InstallPath"="C:\Program Files\FSLogix\Apps\"
      • "InstallVersion"="version_number"
    • \Logging
    • \Profiles
    • \SystemInfo
    • \Telemetry
    • \UserModeDll
  • [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\FSLogix]
    • \ODFC

自訂環境變數

某些 FSLogix 設定會接受環境變數。 這些設定將接受自定義環境變數清單,以及使用者登入期間可用的任何變數。

FSLogix 自定義變數

變數 描述
%username% 已登入使用者的SAMAcountName。
%userdomain% 用戶帳戶所在的 NETBIOS 功能變數名稱。
%sid% 安全性標識碼
%osmajor% 操作系統的主要版本,如以下所示: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentMajorVersionNumber
%osminor% 操作系統的次要版本,如以下所示: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentMinorVersionNumber
%osbuild% 如以下所示的作業系統組建版本: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber
%osservicepack% 舊版 Windows Service Pack,不再使用。
%profileversion% 以 Windows 版本為基礎的配置檔 版本。
%clientname% 起始與主機連線之用戶端的 COMPUTERNAME。

App Services 設定

下列設定適用於 FSLogix,不適用於配置檔或 ODFC 容器或雲端快取。

CleanupInvalidSessions

登錄區: HKEY_LOCAL_MACHINE

登錄路徑: SOFTWARE\FSLogix\Apps

數值名稱: CleanupInvalidSessions

實值類型: DWORD

已啟用值: 1

已停用值: 0 (預設值)

如果使用者的會話突然終止,為使用者配置檔掛接的 VHD(x) 不會正確中斷連結,而且使用者的下一次登入可能不會成功附加其 VHD(x) 容器。 啟用此設定,FSLogix 會嘗試清除這些無效的會話,並允許成功登入。 此設定會影響配置檔和 ODFC 容器。

RoamRecycleBin

登錄區: HKEY_LOCAL_MACHINE

登錄路徑: SOFTWARE\FSLogix\Apps

數值名稱: RoamRecycleBin

實值類型: DWORD

已啟用值: 1 (預設值)

已停用值: 0

啟用時,此設定會為使用者的特定回收站建立重新導向至 VHD(x) 容器。 這可讓使用者還原專案,而不論其從刪除位置的計算機為何。

VHDCompactDisk

登錄區: HKEY_LOCAL_MACHINE

登錄路徑: SOFTWARE\FSLogix\Apps

數值名稱: VHDCompactDisk

實值類型: DWORD

已啟用值: 1 (預設值)

已停用值: 0

啟用時,此設定會在註銷作業期間嘗試壓縮 VHD 磁碟,並設計為根據預先定義的閾值自動減少 Size On Disk 使用者的容器。 如需詳細資訊,請參閱 VHD 磁碟壓縮 檔。

FSLogix 設定 (配置檔、ODFC、雲端快取、記錄)

配置檔案容器設定

下列設定適用於配置檔容器,且會在下列位置建立:

  • 登錄區: HKEY_LOCAL_MACHINE
  • 登錄路徑: SOFTWARE\FSLogix\Profiles

AccessNetworkAsComputerObject

類型: DWORD

預設值:0

資料值和使用

  • 0:預設值 – 以使用者身分附加。
  • 1:附加為計算機 - 資料夾必須具有計算機物件的許可權。

警告

除非您的記憶體提供者或架構不適用於 VHD(x) 容器位置的用戶層級許可權,否則請勿使用此組態設定。 此設定可讓虛擬機存取記憶體提供者上的所有 VHD(x) 檔案,以產生潛在的安全性風險。

AttachVHDSDDL

類型:REG_SZ

預設值:N/A

資料值和使用

SDDL 字串,表示附加 VHD(x) 時要使用的 ACL。

CleanOutNotifications

類型: DWORD

預設值:1

資料值和使用

  • 0:沒有動作。
  • 1:清除過時的通知專案。

此設定會清除 Windows 推播通知平臺 (WPN) 和 Windows 通知設備 (WFN) 所建立的過時專案,在某些情況下會導致登入速度緩慢。

DeleteLocalProfileWhenVHDShouldApply

類型: DWORD

預設值:0

資料值和使用

  • 0:沒有動作。
  • 1:如果存在且符合配置檔容器,則會刪除本機配置檔。

重要

當 FSLogix 判斷使用者應該有 FSLogix 配置檔容器,且本機配置檔存在時,FSLogix 將會永久刪除本機配置檔。

DiffDiskParentFolderPath

類型:REG_SZ

預設值: %TEMP%

資料值和使用

指定當 ProfileType 設定為使用這些磁碟時所建立差異磁碟的路徑。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。

已啟用

(必要設定)

類型: DWORD

預設值:0

資料值和使用

  • 0:已停用配置檔容器。
  • 1:已啟用配置檔容器。

FlipFlopProfileDirectoryName

類型: DWORD

預設值:0

資料值和使用

  • 0:SID 資料夾建立為 %sid%_%username%
  • 1:SID 資料夾會建立為 %username%_%sid%

重要

請務必瞭解如何套用和設定優先順序衝突。

  • 此設定將會覆寫 SIDDirNameMatchSIDDirNamePattern
  • 啟用 NoProfileContainingFolder,此設定沒有效果
  • NoProfileContainingFolder FlipFlopProfileDirectoryName (SIDDirNameMatch> 和 SIDDirNamePattern>

GroupPolicyState

類型: DWORD

預設值:1

資料值和使用

  • 0:不要漫遊組策略狀態,在登入時提供同步原則處理。
  • 1:漫遊組策略狀態,提供登入時的異步原則處理。

注意

無法使用組策略來設定此設定。

IgnoreNonWVD

類型: DWORD

預設值:0

資料值和使用

  • 0:已針對任何會話啟用 FSLogix。
  • 1:僅針對 Azure 虛擬桌面 (AVD) 會話啟用 FSLogix。

注意

Windows 虛擬桌面 (WVD) 現在稱為 Azure 虛擬桌面 (AVD),不過設定的名稱會使用舊版名稱。

InstallAppxPackages

類型: DWORD

預設值:1

資料值和使用

啟用 (1)時,此設定會從使用者配置檔讀取AppxPackages.xml指令清單檔,並安裝/重新註冊應用程式清單。 AppxPackages.xml檔案位於: %LocalAppData%\FSLogix\AppxPackages.xml。 此設定可控制 Windows 中所有 AppX 應用程式的全域行為。 這隻會改善搭配 FSLogix 使用時的功能。

警告

AppxPackages.xml檔案並非要編輯或修改。 編輯此檔案可能會導致非預期的結果,並在每次註銷時覆寫檔案。

IsDynamic

類型: DWORD

預設值:1

資料值和使用

  • 0:VHD(x) 為固定大小,且磁碟上的大小已完全配置。
  • 1:VHD(x) 是動態的,而且只會視需要增加磁碟的大小。

注意

  • 此設定會與 SizeInMBs 設定搭配使用,以管理配置檔容器的大小。 將IsDynamic設定1會導致配置檔容器使用磁碟上的最小空間,而不論配置的SizeInMB為何。 當耗用空間時,磁碟上的大小會成長為 SizeInMBs 中指定的大小。 SizeInMB 是允許使用者在磁碟上使用的大小上限。 如果使用者的配置檔容器成長超過 SizeInMBs 中所指定的內容,則使用者會遇到錯誤。
  • 將 IsDynamic 設定1 不允許配置檔容器成長大於 SizeInMBs 中指定的大小。

KeepLocalDir

類型: DWORD

預設值:0

資料值和使用

  • 0: local_%username% 註銷期間會刪除 。
  • 1:註銷之後,資料夾 local_%username% 將會留在系統上。如果相同的使用者登入,也會再次使用它。

LockedRetryCount

類型: DWORD

預設值:12

資料值和使用

指定 VHD(x) 檔案鎖定時嘗試的重試次數(由另一個進程或計算機開啟)。

LockedRetryInterval

類型: DWORD

默認值:5

資料值和使用

指定要在重試之間等候的秒數(請參閱 LockedRetryCount)。

NoProfileContainingFolder

類型: DWORD

預設值:0

資料值和使用

  • 0:已停用。
  • 1:配置檔容器不會使用或建立包含 VHD(x) 檔案資料夾的 SID。

此設定適用於記憶體提供已為每個使用者唯一的位置。

重要

請務必瞭解如何套用和設定優先順序衝突。

  • 此設定將會覆寫與 容器資料夾相關的任何其他 設定。
    • 搭配此設定使用時,SIDDIRNameMatch 沒有 效果
    • 搭配此設定使用時,SIDDIRNamePattern 沒有 效果
    • FlipFlopProfileDirectoryName 與此設定搭配使用時沒有 效果

OutlookCachedMode

類型: DWORD

預設值:1

資料值和使用

  • 0:防止 FSLogix 使用快取模式執行任何動作。
  • 1:只有在附加配置檔容器時,才會暫時設定啟用快取模式的 Outlook 設定,直到卸離容器為止。 此設定可確保只有在附加容器時,才會使用快取模式。

重要

  • Outlook 必須設定為在線模式,此功能才能運作。 這可確保 FSLogix 是否已停用,將不會下載大型 OST 檔案。
  • 在線模式登錄專案: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\office\16.0\Outlook\OST\NoOST:DWORD = 2
  • FSLogix 會覆寫目前使用者的此設定。

PreventLoginWithFailure

類型: DWORD

預設值:0

資料值和使用

啟用 時 (1) FSLogix 會在連結失敗或使用現有的設定檔 VHD(x) 時載入 FRXShell。 使用者會收到呼叫支援的預設提示,而使用者唯一的選項是註銷。

PreventLoginWithTempProfile

類型: DWORD

預設值:0

資料值和使用

啟用 #1) FSLogix 時,如果判斷已建立暫存配置檔,則會載入FRXShell。 使用者會收到呼叫支援的預設提示,而使用者唯一的選項是註銷。

ProfileDirSDDL

類型:REG_SZ

預設值:N/A

資料值和使用

SDDL 字串,表示建立設定文件目錄時要使用的 ACL。

ProfileType

類型: DWORD

預設值:0

資料值和使用

  • 0:一般配置文件行為。
  • 1:機器應該只有 RW 配置文件實例。
  • 2:機器應該只有 RO 配置文件實例。
  • 3:機器應該嘗試採用 RW 角色,如果無法,則應該回復為 RO 角色。

重要

  • 嘗試同時使用 VHD 的所有工作階段都必須有相符 的 ProfileType 設定。 如果未同時存取 VHD,ProfileType 應該是 0。
  • 在任何情況下,OneDrive 不支援使用相同配置檔的多個同時連線/多個並行連線。 如需詳細資訊,請參閱 在虛擬桌面上使用同步處理應用程式。

ReAttachRetryCount

類型: DWORD

預設值:60

資料值和使用

指定如果系統意外中斷連線,系統應該嘗試重新附加 VHD(x) 容器的次數。

ReAttachIntervalSeconds

類型: DWORD

默認值:10

資料值和使用

指定嘗試在嘗試重新附加 VHD(x) 容器時,在重試之間等待的秒數,如果它意外中斷連線。

RebootOnUserLogoff

類型: DWORD

預設值:0

資料值和使用

  • 0:已停用。
  • 1:在任何用戶註銷時重新啟動。
  • 2:FSLogix 配置檔用戶註銷時重新啟動。

RedirectType

類型: DWORD

默認值:2

資料值和使用

  • 1:使用舊版重新導向。
  • 2:使用 FSLogix 進階重新導向。

警告

除非由 Microsoft 支援服務 指示,否則請勿使用此設定。

RedirXMLSourceFolder

類型:REG_SZ

預設值:N/A

資料值和使用

FSLogix 尋找redirections.xml檔案以從使用者配置檔複製到使用者配置檔的路徑。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。 例如,C:\Windows\System32\\<server-name>\<share-name>

注意

請勿將檔名新增至路徑。 這個設定僅是資料夾路徑。

RemoveOrphanedOSTFilesOnLogoff

類型: DWORD

預設值:0

資料值和使用

  • 0:已停用。
  • 1:註銷期間會刪除重複的 OST 檔案。

注意

在少數情況下,會為使用者建立重複的 OST 檔案。 此情況已記錄在 未使用非持續性配置檔的情況下發生。 當配置檔儲存在標準文件系統中時,系統管理員可以藉由刪除它們來移除孤立或過時的 OST 檔案。 使用 FSLogix 時,OST 檔案位於容器中,而且不可見。 長時間重複的 OST 檔案可能會耗用累加磁碟空間。 啟用 時 (1) FSLogix 會刪除 VHD(x) 中的所有 OST 檔案,但 OST 與最新的修改日期除外。 在選擇啟用此設定之前,系統管理員應該熟悉使用 OST 檔案和潛在影響。

RoamIdentity

類型: DWORD

預設值:0

資料值和使用

  • 0:不要漫遊容器內的認證和令牌。
  • 1:針對 Web 帳戶管理員 (WAM) 系統所建立的認證和令牌啟用舊版漫遊。

在某些身分識別和驗證案例中,使用者可能需要在每個登入時向Microsoft 365 個應用程式進行驗證。 啟用此設定是解決此問題的其中一種方式。 我們建議使用真正的單一登錄,讓您的 Windows 登入能夠將其認證傳遞至您的 Microsoft 365 應用程式。

重要

  • 默認設定是 不要漫遊慣用設定的認證或令牌 。 雖然這可能不是某些客戶的理想設定,但我們建立了此設定,以提供客戶漫遊這些專案的方式,類似於 FSLogix v2201 Hotfix 2 (2.9.8228.50276)。
  • 如果您使用 Microsoft Intune 來管理您的裝置,或您的裝置 Microsoft已加入 Entra,請勿啟用此設定。

RoamSearch

類型: DWORD

預設值:0

資料值和使用

  • 0:已停用。
  • 1:啟用單一使用者搜尋。
  • 2:啟用多用戶搜尋。

如需詳細資訊,請參閱 設定 Windows 搜尋資料庫漫遊

重要

  • 較新版本的 Windows1 不再需要 FSLogix 搜尋漫遊功能
  • RoamSearch 是在套用 GPO 之前設定的,因此無法在開機時套用 GoldImage 的環境中,依賴 GPO 來設定 RoamSearch。

1 Windows Server 2019 1809 版和更新版本、Windows 10 和 11 多重會話

SetTempToLocalPath

類型: DWORD

默認值:3

資料值和使用

  • 0:已停用。
  • 1:將 TEMP 和 TMP 重新導向至本機磁碟驅動器。
  • 2:將 INetCache 重新導向至本機磁碟驅動器。
  • 3:將 TEMP、TMP 和 INetCache 重新導向至本機磁碟驅動器。

ShutdownOnUserLogoff

類型: DWORD

預設值:0

資料值和使用

  • 0:已停用。
  • 1:在任何使用者註銷時關機。
  • 2:FSLogix 使用者註銷時關機。

SIDDirNameMatch

類型:REG_SZ

預設值: %sid%_%username%

資料值和使用

指定比對配置檔或 ODFC 容器資料夾時所使用的字串模式。 使用此設定來定義 FSLogix 如何嘗試尋找使用者配置檔或 ODFC 容器。 FSLogix 會使用 VHDLocationsCCDLocations 作為要搜尋的位置,而此設定會定義要搜尋的內容。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。

重要

請務必瞭解如何套用和設定優先順序衝突。

  • 使用此組態設定時,請確定 SIDDIRNamePattern 值符合此設定。
    • 啟用 FlipFlopProfileDirectoryName,此設定沒有作用
    • 啟用 NoProfileContainingFolder,此設定沒有效果
    • NoProfileContainingFolder>FlipFlopProfileDirectoryName SIDDirNameMatch> (此設定)

SIDDirNamePattern

類型:REG_SZ

預設值: %sid%_%username%

資料值和使用

指定建立設定檔或 ODFC 容器資料夾時所使用的字串模式。 使用此設定來定義 FSLogix 如何嘗試建立使用者配置檔或 ODFC 容器資料夾。 FSLogix 會使用 VHDLocationsCCDLocations 作為要建立的位置,而此設定會定義要建立的內容。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。

重要

請務必瞭解如何套用和設定優先順序衝突。

  • 使用此組態設定時,請確定 SIDDIRNameMatch 值符合此設定。
    • 啟用 FlipFlopProfileDirectoryName,此設定沒有作用
    • 啟用 NoProfileContainingFolder,此設定沒有效果
    • NoProfileContainingFolder>FlipFlopProfileDirectoryName SIDDirNamePattern> (此設定)

SIDDirSDDL

類型:REG_SZ

預設值:N/A

資料值和使用

SDDL 字串,表示建立 SID 容器資料夾時要使用的 ACL。

SizeInMBs

類型: DWORD

默認值:30000

資料值和使用

指定使用者容器的大小上限,以 MB 為單位。 新建立的 VHD(x) 容器大小為這個大小。 在使用者登入期間,現有的容器會自動擴充至此大小。 您可以隨時增加此值,但無法加以減少。 減少此值不會造成現有的 VHD(x) 容器壓縮。

VHDNameMatch

類型:REG_SZ

預設值: Profile*

資料值和使用

指定比對使用者配置檔容器時所使用的字串模式。 使用此設定來定義 FSLogix 如何 嘗試尋找 使用者配置檔容器 (VHD(x) 檔案)。 FSLogix 會使用 VHDLocationsCCDLocations 作為要搜尋的位置,而此設定會定義要搜尋的內容。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。

重要

使用此組態設定時,請確定 VHDNamePattern 值符合此設定。

VHDNamePattern

類型:REG_SZ

預設值: Profile_%username%

資料值和使用

指定建立使用者配置檔容器時所使用的字串模式。 使用此設定來定義 FSLogix 如何 嘗試建立 使用者配置檔容器 (VHD(x) 檔案)。 FSLogix 會使用 VHDLocationsCCDLocations 作為要搜尋的位置,而此設定會定義要建立的內容。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。

重要

使用此組態設定時,請確定 VHDNameMatch 值符合此設定。

VHDLocations

(必要設定)

類型:MULTI_SZ或REG_SZ

預設值:N/A

資料值和使用

要搜尋使用者配置檔 VHD(x) 檔案的 SMB 位置清單。 如果找不到,則在第一個列出的位置建立檔案。 如果 VHD 路徑不存在,則會在檢查路徑中是否存在 VHD(x) 之前先建立它。 路徑支援在登入過程中使用 FSLogix 自定義變數 或任何可供使用者使用的環境變數。 當指定為REG_SZ值時,必須以分號 (;) 分隔多個位置。

VHDXSectorSize

類型: DWORD

預設值:0

資料值和使用

  • 0:使用系統預設值。
  • 512:VHD(x) 會使用512位元組配置來格式化。
  • 4096:VHD(x) 會使用 4096 位元組配置來格式化。

注意

值會列在十進位而非十六進位中。

VolumeType

類型:REG_SZ

默認值:vhd

資料值和使用

vhd 的值表示新建立的檔案應為 VHD 類型。 vhdx 的值表示新建立的檔案應該為 VHDX 類型

VolumeWaitTimeMS

類型: DWORD

默認值:20000

資料值和使用

指定系統應該等候磁碟區在附加 VHD(x) 之後到達的毫秒數。 預設值 20000 = 20 秒