通过

配置设置参考

  • 项目

本文概述了适用于 FSLogix 的各种注册表设置，包括但不限于：

  • 应用服务
  • 配置文件容器
  • ODFC 容器
  • 云缓存
  • Logging

默认设置

安装 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 服务s 设置

以下设置适用于 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

数据值和使用：

表示附加 VHD（x）时要使用的 ACL 的 SDDL 字符串。

CleanOutNotifications

类型：DWORD

默认值：1

数据值和使用：

  • 0：无操作。
  • 1：清除过时的通知条目。

此设置清除 Windows 推送通知平台（WPN）和 Windows 通知设施（WFN）创建的过时条目，在某些情况下会导致登录速度缓慢。

DeleteLocalProfileWhenVHDShouldApply

类型：DWORD

默认值：0

数据值和使用：

  • 0：无操作。
  • 1：删除本地配置文件（如果存在）并匹配配置文件容器。

重要

当 FSLogix 确定用户应具有 FSLogix 配置文件容器并且存在本地配置文件时，FSLogix 将永久删除本地配置文件。

DiffDiskParentFolderPath

类型: REG_SZ

默认值：%TEMP%

数据值和使用：

指定配置文件类型配置为使用这些磁盘时创建差异磁盘的路径。 该路径支持在登录过程中使用 FSLogix 自定义变量 或任何可供用户使用的环境变量。

已启用

（必需设置）

类型：DWORD

默认值：0

数据值和使用：

  • 0：已禁用配置文件容器。
  • 1：已启用配置文件容器。

FlipFlopProfileDirectoryName

类型：DWORD

默认值：0

数据值和使用：

  • 0：SID 文件夹创建为 %sid%_%username%
  • 1：SID 文件夹创建为 %username%_%sid%

重要

请确保你了解如何应用和设置优先级冲突。

  • 此设置将 覆盖 SIDDirNameMatch 和 SIDDirNamePattern
  • 启用 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 此设置可控制所有 AppX 应用程序的 Windows 中的全局行为。 这只会在与 FSLogix 一起使用时改进功能。

警告

AppxPackages.xml文件不应编辑或修改。 编辑此文件可能会导致意外结果，每次注销时都会覆盖该文件。

IsDynamic

类型：DWORD

默认值：1

数据值和使用：

  • 0：VHD（x）大小固定，磁盘上的大小已完全分配。
  • 1：VHD（x）是动态的，仅根据需要增加磁盘的大小。

注意

  • 此设置与 SizeInMBs 设置一起使用，用于管理配置文件容器的大小。 将 IsDynamic 设置为 1 会导致配置文件容器使用磁盘上的最小空间，而不考虑分配 的 SizeInMB。 随着空间的消耗，磁盘上的大小将增长到 SizeInMBs 中指定的大小。 SizeInMBs 是允许用户在磁盘上使用的最大大小。 如果用户的配置文件容器超出 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 具有 NO EFFECT 。
    • 与此设置结合使用时，SIDDIRNamePattern 具有 NO EFFECT 。
    • 当与此设置结合使用时，FlipFlopProfileDirectoryName 具有 NO EFFECT 。

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

数据值和使用：

表示创建配置文件目录时要使用的 ACL 的 SDDL 字符串。

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 修补程序 2（2.9.82228.50276）。
  • 如果使用 Microsoft Intune 来管理设备，或者设备Microsoft已加入 Entra，请不要启用此设置。

RoamSearch

类型：DWORD

默认值：0

数据值和使用：

  • 0：已禁用。
  • 1：启用单用户搜索。
  • 2：启用多用户搜索。

有关详细信息，请参阅 配置 Windows 搜索数据库漫游。

重要

  • 在较新版本的 Windows1 中不再需要 FSLogix 搜索漫游功能
  • RoamSearch 是在应用 GPO 之前设置的，不能依赖于 GPO 在启动时应用 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 使用 VHDLocations 或 CCDLocations 作为要搜索的位置，此设置定义要搜索的内容。 该路径支持在登录过程中使用 FSLogix 自定义变量 或任何可供用户使用的环境变量。

重要

请确保你了解如何应用和设置优先级冲突。

  • 使用此配置设置时，请确保 SIDDIRNamePattern 值与此设置匹配。
    • 启用 FlipFlopProfileDirectoryName 时，此设置没有效果。
    • 启用 NoProfileContainingFolder 时，此设置没有效果。
    • NoProfileContainingFolder FlipFlopProfileDirectoryName>SIDDirNameMatch （此设置）>

SIDDirNamePattern

类型: REG_SZ

默认值： %sid%_%username%

数据值和使用：

指定在创建配置文件或 ODFC 容器文件夹时使用的字符串模式。 使用此设置定义 FSLogix 如何尝试创建用户配置文件或 ODFC 容器文件夹。 FSLogix 使用 VHDLocations 或 CCDLocations 作为创建位置，此设置定义要创建的内容。 该路径支持在登录过程中使用 FSLogix 自定义变量 或任何可供用户使用的环境变量。

重要

请确保你了解如何应用和设置优先级冲突。

  • 使用此配置设置时，请确保 SIDDIRNameMatch 值与此设置匹配。
    • 启用 FlipFlopProfileDirectoryName 时，此设置没有效果。
    • 启用 NoProfileContainingFolder 时，此设置没有效果。
    • NoProfileContainingFolder FlipFlopProfileDirectoryName>SIDDirNamePattern （此设置）>

SIDDirSDDL

类型: REG_SZ

默认值：N/A

数据值和使用：

表示创建 SID 容器文件夹时要使用的 ACL 的 SDDL 字符串。

SizeInMB

类型：DWORD

默认值：30000

数据值和使用：

指定用户容器的最大大小（以 MB 为单位）。 新建的 VHD（x） 容器的大小为此大小。 在用户登录期间，现有容器会自动扩展到此大小。 可以随时增加此值，但不能减小该值。 降低此值不会导致现有 VHD（x） 容器收缩。

VHDNameMatch

类型: REG_SZ

默认值： Profile*

数据值和使用：

指定匹配用户配置文件容器时使用的字符串模式。 使用此设置定义 FSLogix 如何尝试 查找 用户配置文件容器 （VHD（x） 文件）。 FSLogix 使用 VHDLocations 或 CCDLocations 作为要搜索的位置，此设置定义要搜索的内容。 该路径支持在登录过程中使用 FSLogix 自定义变量 或任何可供用户使用的环境变量。

重要

使用此配置设置时，请确保 VHDNamePattern 值与此设置匹配。

VHDNamePattern

类型: REG_SZ

默认值： Profile_%username%

数据值和使用：

指定创建用户配置文件容器时使用的字符串模式。 使用此设置定义 FSLogix 如何尝试 创建 用户配置文件容器 （VHD（x） 文件）。 FSLogix 使用 VHDLocations 或 CCDLocations 作为要搜索的位置，此设置定义要创建的内容。 该路径支持在登录过程中使用 FSLogix 自定义变量 或任何可供用户使用的环境变量。

重要

使用此配置设置时，请确保 VHDNameMatch 值与此设置匹配。

VHDLocations

（必需设置）

类型：MULTI_SZ或REG_SZ

默认值：N/A

数据值和使用：

用于搜索用户配置文件 VHD（x） 文件的 SMB 位置列表。 如果找不到，将在第一个列出的位置创建一个。 如果 VHD 路径不存在，则会在检查路径中是否存在 VHD（x）之前创建它。 该路径支持在登录过程中使用 FSLogix 自定义变量 或任何可供用户使用的环境变量。 指定为REG_SZ值时，必须使用分号（;）分隔多个位置。

VHDXSectorSize

类型：DWORD

默认值：0

数据值和使用：

  • 0：使用系统默认值。
  • 512：使用 512 字节分配设置 VHD（x）的格式。
  • 4096：VHD（x）使用 4096 字节分配进行格式化。

注意

值列在十进制而不是十六进制中。

VolumeType

类型: REG_SZ

默认值：vhd

数据值和使用：

vhd 的值表示新创建的文件应为 VHD 类型。 vhdx 的值表示新创建的文件应为 VHDX 类型。

VolumeWaitTimeMS

类型：DWORD

默认值：20000

数据值和使用：

指定系统应在附加 VHD（x） 后等待卷到达的毫秒数。 默认值 20000 = 20 秒