Настраиваемый профиль redirections.xml

Внимание

Предстоящее изменение в Windows Server, включенное в обновление за апрель 2026 г., заключается в том, что по умолчанию тип шифрования Kerberos изменяется с RC4 на AES-SHA1.

Общие папки, в которых размещаются контейнеры FSLogix, которые не обновляются до AES-SHA1 могут иметь проблемы с доступом после применения этого изменения. Чтобы избежать сбоев, выполните обновление до AES-SHA1 перед установкой обновления.

Клиенты, которые уже обновились до AES-SHA1, не затронуты.

Дополнительные сведения см. в блоге FSLogix: Требуемое действие: ужесточение Windows Kerberos (RC4) может повлиять на профили FSLogix в хранилище SMB.

Пользовательские перенаправления профилей настраиваются с помощью XML-файла (redirections.xml), расположенного в контейнере профиля пользователя. FSLogix не создает файл redirections.xml. Файл redirections.xml копируется в контейнер профиля пользователя из исходного расположения. В большинстве случаев исходное расположение — это удаленный файловый ресурс, где пользователи имеют доступ к копированию из контейнера профилей и из него. В этом документе содержатся сведения о файле redirection.xml и о том, как лучше реализовать его для конкретного варианта использования.

Когда следует использовать redirections.xml

Данные в профиле пользователя не предназначены для удаления или исключения. Если у вас нет доскональных знаний о данных в профиле или приложении, не исключайте их из контейнера.

Включение и исключение файлов и папок в контейнер профиля

Чтобы включить или исключить файлы и /или папки в контейнере профилей пользователей, необходимо создать файл с именем redirections.xml. Этот файл определяет, что скопировать или исключить в/из контейнера профиля пользователя. XML-файл обрабатывается во время входа пользователей и выхода из виртуальной машины. Любые изменения, внесенные в XML-файл во время входа пользователя в виртуальную машину, не вступают в силу, пока не выйдите и не войдете в систему.

Удаление или переименование XML-файла в исходном расположении не удаляет или не переименовывает его для пользователей. Если необходимо удалить пользовательские перенаправления, удалите содержимое XML-файла и сохраните его в исходном расположении. После следующего входа обновленный файл будет скопирован в контейнер профиля пользователя.

Примечание.

redirections.xml применимо только при использовании с контейнерами профилей и не оказывает никакого эффекта при использовании контейнеров ODFC.

Расположения для redirections.xml

XML-файл содержит два местоположения. Исходное расположение, как правило — это сетевая папка, а также расположение в контейнере профиля пользователя.

Расположение исходного файла

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. Папка документов
      • 8. Папка загрузки
      • 16. Папка ссылок
      • 32. Папки музыки
      • 64. Папки "Изображения и видео"
      • 128. Папки, участвующие в процессах низкого уровня целостности, таких как AppData\LocalLow
    • Исключение: этот элемент используется для коллекции вложенных Exclude элементов.

      • Исключить: Этот элемент описывает одно местоположение, чтобы исключить из контейнера пользователя. Путь, используемый в этих элементах, должен существовать в пути профиля пользователя (%userprofile%). Путь ни в коем случае не должен включать C:\Users\%username% часть пути.
        • Копировать: этот атрибут определяет, как FSLogix обрабатывает файлы и папки во время перенаправления. Атрибут может быть опущен в элементе, что эквивалентно использованию значения 0.
          • 0. Создает пустую папку в каталоге local_%username% . Во время операции файлы не копируются. Copy 0 — это наиболее распространенное значение, используемое для уменьшения содержимого профиля пользователя. Любые данные, которые уже находятся в контейнере по этому адресу, не удаляются. Только будущие данные создаются в local_%username% папке во время сеанса пользователя и удаляются при выходе.
          • 1. Создает папку в каталоге local_%username% и копирует файлы ИЗ указанного расположения. Данные в контейнере копируются в папку local_%username%, и все новые данные также записываются в этот путь. При выходе пользователя local_%username% удаляется, и все новые данные теряются. Nth sign ins всегда копирует данные из контейнера в папку local_%username% .
          • 2. Создает папку в каталоге local_%username% И копирует файлы в указанное расположение. Создана новая (пустая) папка в . Во время сеанса пользователя данные записываются в этот путь. При выходе из системы данные копируются в контейнер. Не используйте это значение, если не направлен инженер службы поддержки Майкрософт.
          • 3. Создает папку в каталоге local_%username% И копирует файлы ИЗ и В указанное расположение. Это значение объединяет эффекты от 1 и 2. Существующие данные копируются из контейнера и в папку local_%username% . Новые данные записываются в local_%username% путь и при выходе все данные копируются обратно в контейнер.
    • Включает: этот элемент используется для коллекции вложенных Include элементов.

      • Включить: Этот элемент используется для того, чтобы подкаталог, исключенный из основного пути, оставался в контейнере. Значение COPY не используется в этих элементах. Путь, используемый в этих элементах, должен существовать в пути профиля пользователя (%userprofile%). Путь ни в коем случае не должен включать C:\Users\%username% часть пути.

      Примечание.

      • Папка или данные должны существовать в профиле, чтобы они были включены обратно в контейнер. Например, новые профили с помощью FSLogix с инструкцией include могут не иметь все структуры папок, созданные для определенного пути, так как пользователь никогда не использовал приложение в контексте контейнера профиля FSLogix.
      • Родительская папка включенного пути к папке должна существовать в контейнере для правильной работы включения.
      • XML-файл принимает любое количество Include элементов и Exclude элементов.

Пример redirections.xml

Внимание

В этом примере показано, как можно использовать элементы, и показано, что их не следует использовать в производственной среде. Следуйте инструкциям по созданию и реализации redirections.xml для реализации XML в реальном мире. Исключения и включения могут иметь непредвиденные последствия и должны быть созданы с осторожностью.

  1. Исключите известные папки (контакты, ссылки и музыка)
  2. Исключите приложение Contoso Sales, скопировав любые данные из контейнера в папку local_%username% и обратно в контейнер при выходе из системы. Операция исключения с копированием перемещает процессы ввода/вывода данных на локальный диск вместо контейнера1.
  3. Исключите папку Contoso Web App без операции копирования (все данные удаляются при выходе).
  4. Включите папкуSettings обратно в исключенную папку Contoso Web App.

Для копирования данных по-прежнему требуется 1 ввода-вывода.

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

Примечание.

  • В Windows 8 и более поздних версиях папки, участвующие в процессах низкого уровня целостности, всегда перенаправляются в local_%username% каталог.
  • Если одна и та же папка указана как в элементе Exclude, так и в элементе Include, элемент Exclude будет иметь приоритет.
  • Чтобы перечислить перенаправления, установленные FSLogix, используйте утилиту командной строки frx.

Следующие шаги