Справочник по параметрам конфигурации

В этой статье описаны различные параметры реестра, применимые к FSLogix, которые включают, но не ограничиваются:

  • Службы приложений
  • Контейнеры профилей
  • Контейнеры ODFC
  • Облачный кэш
  • Ведение журнала

Параметры по умолчанию

После установки FSLogix установщик создаст базовый набор разделов реестра и значений, который предоставляет платформу для добавления параметров конфигурации. FSLogix не создает имена значений параметров конфигурации в рамках установки. Любой параметр конфигурации, указанный на этой странице с значением по умолчанию, не должен быть создан или настроен, так как 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:

«Переменная» Description
%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 больше не используются.
%profileversion% Версия профиля на основе версии Windows.
%clientname% ИМЯ КОМПЬЮТЕРА клиента, инициирующего подключение к узлу.

Параметры Служба приложений

Следующие параметры применимы к FSLogix и не относятся к профилям или контейнерам ODFC или облачному кэшу.

CleanupInvalidSessions

Hive реестра: HKEY_LOCAL_MACHINE

Путь к реестру: SOFTWARE\FSLogix\Apps

Имя значения: CleanupInvalidSessions

Тип значения: DWORD

Включенное значение: 1

Отключенное значение: 0 (по умолчанию)

В случаях, когда сеанс пользователя внезапно завершается, VHD(x) подключен к профилю пользователя неправильно отсоединяется, а следующий вход пользователя может не успешно подключить контейнер VHD(x). Включите этот параметр и FSLogix пытается очистить эти недопустимые сеансы и разрешить успешный вход. Этот параметр влияет на контейнеры Profile и ODFC.

RoamRecycleBin

Hive реестра: HKEY_LOCAL_MACHINE

Путь к реестру: SOFTWARE\FSLogix\Apps

Имя значения: RoamRecycleBin

Тип значения: DWORD

Включенное значение: 1 (по умолчанию)

Отключенное значение: 0

Если этот параметр включен, этот параметр создает перенаправление для конкретной корзины пользователя в контейнер VHD(x). Это позволяет пользователю восстанавливать элементы независимо от компьютера, из которого они были удалены.

VHDCompactDisk

Hive реестра: HKEY_LOCAL_MACHINE

Путь к реестру: SOFTWARE\FSLogix\Apps

Имя значения: VHDCompactDisk

Тип значения: DWORD

Включенное значение: 1 (по умолчанию)

Отключенное значение: 0

Если этот параметр включен, этот параметр пытается сократить диск VHD во время операции выхода и предназначен для автоматического уменьшения Size On Disk контейнера пользователя в зависимости от предопределенного порогового значения. Дополнительные сведения см. в документации по компактированию дисков VHD.

Параметры FSLogix (профиль, ODFC, облачный кэш, ведение журнала)

Параметры контейнера профиля

Следующие параметры применимы к контейнерам профилей и создаются в следующем расположении:

  • Hive реестра: HKEY_LOCAL_MACHINE
  • Путь к реестру: SOFTWARE\FSLogix\Profiles

AccessNetworkAsComputerObject

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

  • 0: по умолчанию — присоединение от имени пользователя.
  • 1. Подключение как компьютер — папка должна иметь разрешения для объектов компьютера.

Внимание

Не используйте этот параметр конфигурации, если поставщик хранилища или архитектура не будут работать с разрешениями на уровне пользователя для расположений контейнеров VHD(x). Этот параметр позволит виртуальной машине получить доступ ко всем файлам VHD(x) в поставщике хранилища, создав потенциальный риск безопасности.

AttachVHDSDDL

Тип: REG_SZ

Значение по умолчанию: N/A

Значения данных и использование:

Строка SDDL, представляющая списки управления доступом для использования при подключении VHD(x).

CleanOutNotifications

Тип: DWORD

Значение по умолчанию: 1

Значения данных и использование:

  • 0. Нет действия.
  • 1. Очистка устаревших записей уведомлений.

Этот параметр очищает устаревшие записи, созданные платформой push-уведомлений 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%

Внимание

Убедитесь, что вы понимаете, как применяются и приоритеты конфликтующих параметров.

  • Этот параметр ПЕРЕОПРЕДЕЛИТ КАК SIDDirNameMatch, так и SIDDirNamePattern
  • Этот параметр имеет ЗНАЧЕНИЕ NO EFFECT при включении NoProfileContainingFolder
  • NoProfileContainingFolder>FlipFlopProfileDirectoryName> (SIDDirNameMatch и SIDDirNamePattern)

GroupPolicyState

Тип: DWORD

Значение по умолчанию: 1

Значения данных и использование:

  • 0. Не перемещайте состояние групповой политики, обеспечивает синхронную обработку политик при входе.
  • 1. Состояние групповой политики роуминга обеспечивает асинхронную обработку политик при входе.

Примечание.

Этот параметр нельзя задать с помощью групповой политики.

IgnoreNonWVD

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

  • 0. FSLogix включен для любого сеанса.
  • 1. FSLogix включен только для сеансов виртуального рабочего стола Azure (AVD).

Примечание.

Виртуальный рабочий стол 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 to 1 приводит к тому, что контейнер profile использует минимальное пространство на диске независимо от выделенных объектов SizeInMBs. По мере использования пространства размер на диске увеличивается до размера, указанного в SizeInMBs. SizeInMBs — это максимальный размер, который пользователь может использовать на диске. Если контейнер профиля пользователя выходит за рамки указанного в SizeInMBs ошибок пользователя.
  • Параметр IsDynamic to 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).

Этот параметр предназначен для ситуаций, когда хранилище предоставляет расположение, которое уже уникально для каждого пользователя.

Внимание

Убедитесь, что вы понимаете, как применяются и приоритеты конфликтующих параметров.

  • Этот параметр переопределит любой другой параметр, связанный с папками контейнеров.
    • 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 загружает FRXShell, если к нему подключен сбой или использование существующего виртуального жесткого диска профиля(x). Пользователь получает запрос по умолчанию на звонок в службу поддержки, и единственным вариантом является выход.

PreventLoginWithTempProfile

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

При включении (1) FSLogix загружает FRXShell, если он определен временный профиль. Пользователь получает запрос по умолчанию на звонок в службу поддержки, и единственным вариантом является выход.

ProfileDirSDDL

Тип: REG_SZ

Значение по умолчанию: N/A

Значения данных и использование:

Строка SDDL, представляющая списки управления доступом для использования при создании каталога профилей.

ProfileType

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

  • 0. Обычное поведение профиля.
  • 1. Компьютер должен быть только экземпляром профиля RW.
  • 2. Компьютер должен быть только экземпляром профиля RO.
  • 3. Компьютер должен попытаться принять роль RW и, если он не может, он должен вернуться к роли RO.

Внимание

  • Все сеансы, пытающиеся использовать виртуальный жесткий диск одновременно, должны иметь соответствующий параметр ProfileType . Если виртуальный жесткий диск недоступна одновременно, profileType должен иметь значение 0.
  • OneDrive не поддерживает несколько одновременных подключений или нескольких одновременных подключений, используя один и тот же профиль в любых обстоятельствах. Дополнительные сведения см. в статье "Использование приложения синхронизации на виртуальных рабочих столах".

ReAttachRetryCount

Тип: DWORD

Значение по умолчанию: 60

Значения данных и использование:

Указывает количество попыток повторного подключения контейнера VHD(x), если он непредвиденно отключен.

ReAttachIntervalSeconds

Тип: DWORD

Значение по умолчанию: 10

Значения данных и использование:

Указывает количество секунд ожидания между повторными попытками при попытке повторного подключения контейнера VHD(x), если он неожиданно отключен.

ПерезагрузкаOnUserLogoff

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

  • 0. Отключено.
  • 1. Перезагрузка при выходе любого пользователя.
  • 2. Перезагрузка при выходе пользователя профиля FSLogix.

RedirectType

Тип: DWORD

Значение по умолчанию: 2

Значения данных и использование:

  • 1. Использование устаревшего перенаправления.
  • 2. Использование расширенного перенаправления FSLogix.

Внимание

Не используйте этот параметр, если не направляется служба поддержки Майкрософт.

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, все OST-файлы будут удалены в VHD(x), за исключением OST с последней датой изменения. Администраторы должны ознакомиться с использованием OST-файлов и возможных последствий, прежде чем включить этот параметр.

RoamIdentity

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

  • 0. Не перемещайте учетные данные и маркеры в контейнере.
  • 1. Включает устаревший роуминг для учетных данных и маркеров, созданных системой диспетчера веб-учетных записей (WAM).

В некоторых сценариях идентификации и проверки подлинности пользователю может потребоваться пройти проверку подлинности в приложениях Microsoft 365 при каждом входе. Включение этого параметра является одним из способов устранения проблемы. Мы рекомендуем работать над истинным единым входом, который позволяет вашему входу Windows передавать учетные данные в приложения Microsoft 365.

Внимание

  • Параметр по умолчанию не перемещает учетные данные или маркеры , которые являются предпочтительным параметром. Хотя это не может быть идеальной конфигурацией для некоторых клиентов, мы создали этот параметр, чтобы предоставить клиентам способ перемещения этих элементов аналогично исправлению FSLogix версии 2201 (2.9.8228.50276).
  • Не включите этот параметр, если вы используете Microsoft Intune для управления устройствами или присоединение устройств к Microsoft Entra.

RoamSearch

Тип: DWORD

Значение по умолчанию: 0

Значения данных и использование:

  • 0. Отключено.
  • 1. Включение однопользовательского поиска.
  • 2. Включение многопользовательского поиска.

Дополнительные сведения см. в разделе "Настройка перемещения базы данных поиска Windows".

Внимание

  • Функции перемещения поиска FSLogix больше не требуются в более новых версиях Windows1
  • RoamSearch устанавливается до применения объектов групповой политики, невозможно полагаться на объекты групповой политики, чтобы задать RoamSearch в средах, где goldImage применяется при загрузке.

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 соответствует этому параметру.
    • Этот параметр имеет ЗНАЧЕНИЕ NO EFFECT при включении FlipFlopProfileDirectoryName .
    • Этот параметр имеет значение NO EFFECT при включении NoProfileContainingFolder .
    • NoProfileContainingFolder FlipFlopProfileDirectoryName>SIDDirNameMatch (этот параметр)>

SIDDirNamePattern

Тип: REG_SZ

Значение по умолчанию: %sid%_%username%

Значения данных и использование:

Задает шаблон строки, используемый при создании профиля или папки контейнера ODFC. Используйте этот параметр, чтобы определить, как FSLogix пытается создать профиль пользователей или папку контейнера ODFC. FSLogix использует VHDLocations или CCDLocations в качестве расположения, где нужно создать, и этот параметр определяет, что нужно создать. Путь поддерживает использование пользовательских переменных FSLogix или любых переменных среды, доступных пользователю во время входа.

Внимание

Убедитесь, что вы понимаете, как применяются и приоритеты конфликтующих параметров.

  • При использовании этого параметра конфигурации убедитесь, что значение SIDDIRNameMatch соответствует этому параметру.
    • Этот параметр имеет ЗНАЧЕНИЕ NO EFFECT при включении FlipFlopProfileDirectoryName .
    • Этот параметр имеет значение NO EFFECT при включении NoProfileContainingFolder .
    • NoProfileContainingFolder FlipFlopProfileDirectoryName>SIDDirNamePattern (этот параметр)>

SIDDirSDDL

Тип: REG_SZ

Значение по умолчанию: N/A

Значения данных и использование:

Строка SDDL, представляющая списки управления доступом для использования при создании папки контейнера SID.

SizeInMBs

Тип: DWORD

Значение по умолчанию: 30000

Значения данных и использование:

Задает максимальный размер контейнера пользователя в мегабайтах. Только что созданные контейнеры 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

Значения данных и использование:

Список расположений SMB для поиска файла VHD(x) профиля пользователя. Если он не найден, он создается в первом указанном расположении. Если путь виртуального жесткого диска не существует, он создается перед проверкой наличия 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 секунд