共用方式為


組態設定參考

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

  • APP 服務
  • 配置檔案容器
  • 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

登錄 Hive: 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,此設定沒有效果
  • >

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 配置檔用戶註銷時重新啟動。

重定向類型

類型: 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:啟用身分資料的舊版漫遊。

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

如需詳細資訊,請參閱我們的基於刪除的設定檔排除。

重要

  • 預設設定是 不漫遊身分資料 ,這是建議的設定。
  • 如果您使用 Microsoft Intune 來管理您的裝置,或您的裝置 Microsoft已加入 Entra,請勿啟用此設定。

RoamSearch

類型: DWORD

預設值:0

資料值和使用

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

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

重要

  • 較新版本的 Windows1 不再需要 FSLogix 搜尋漫遊功能
  • RoamSearch 會在套用 GPO 之前設定。 您無法依賴 GPO 在 GoldImage 在開機時套用 GoldImage 的環境中設定 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。

大小(MB)

類型: 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 位元組配置來格式化。

注意

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

音量類型

類型:REG_SZ

默認值:vhd

資料值和使用

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

VolumeWaitTimeMS

類型: DWORD

默認值:20000

資料值和使用

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