служебная программа командной строки frx

Статья
11/10/2023

frx — это программа командной строки, которая обеспечивает управление и настройку конфигурации FSLogix. Программа управляет правилами, профилями и контейнерами, поиском, диспетчером учетных данных и другими функциями.

Команды

Команда	Description
Справка?	Отображение этого сообщения справки
version	Отображение версий загруженных компонентов

Правила

Команда	Description
перенаправление надстроек	Добавление перенаправления папок
правило надстройки	Добавление указанного правила
набор правил create-rules	Создает набор правил
del-redirect	Удаление перенаправления активных папок
del-rule	Удаление указанного правила
list-redirects	Вывод списка активных перенаправлений папок
правила list-rules	Вывод списка загруженных правил
перезагрузить правила	Перезагрузить правила из кэша

Профили и виртуальные контейнеры

Команда	Description
профиль копирования	Копирование профиля пользователя в VHD или VHDX
copyto-vhd	Копирование папки и его содержимого в VHD или VHDX
create-vhd	Создание и форматирование виртуального жесткого диска или VHDX
изменение профиля	Изменение содержимого профиля, содержащегося в VHD или VHDX
begin-edit-profile	Присоединяет указанные VHD или VHDX и куст реестра
end-edit-profile	Отсоединяет указанный VHD или VHDX и куст реестра
export-profilecfg	Экспорт параметров конфигурации профиля в файл
import-profilecfg	Импорт параметров конфигурации профиля из файла
миграция vhd	Перенос содержимого существующего виртуального жесткого диска в новый
moveto-vhd	Перемещение папки и его содержимого в VHD или VHDX
set-profile-redir	Задает конфигурацию перенаправления папок профиля

Компонент поиска

Команда	Description
reset-user-search-db	Переиндексирование базы данных индекса поиска пользователя.

Управление ключами Диспетчера учетных данных

Команда	Description
add-secure-key	Добавление безопасного ключа в Диспетчер учетных данных
del-secure-key	Удаление безопасного ключа из Диспетчера учетных данных
list-secure-key	список ключей, содержащихся в Диспетчере учетных данных

Разное

Команда	Description
create-junction	Создает точку соединения с целевым томом или папкой
enable-shnot	Включает уведомление об обновлении оболочки
regfont	Регистрирует шрифт в системной таблице шрифтов
назначение отчета	Отчеты о применимости набора правил
show-junction-info	Отображение сведений о точке соединения
unregfont	Удаляет шрифт из таблицы системных шрифтов
агент start-agent	Запускает все драйверы и службы, состоящие из агента
stop-agent	Останавливает все драйверы и службы, состоящие из агента

версия frx

Отображает версии загруженных компонентов

Примеры

    frx version

Правила

frx add-redirect

Добавление нового перенаправления пути для драйвера виртуализации

    frx add-redirect -src <path>
                     -dest <path>

Обязательные параметры

-source или -src

Указывает исходный путь для перенаправления.

-destination или -dest

Указывает путь, который будет выступать в качестве целевого объекта перенаправления.

Примеры

    frx add-redirect -src C:\mysource -dest d:\mytest
    frx add-redirect -src C:\mysource -dest \\?\VolumeXXXXX\Test

frx add-rule

Добавьте определенное правило.

    frx add-rule -hide <params>
                 -printer <params>
                 -redirect <params>
                 -specific-data <params>
                 -vhd-attach <params>

Примеры

    frx add-rule -hide -src-parent C:\Windows
    frx add-rule -hide -src-parent \Registry\User\*\Software -src MySoftware  
    frx add-rule -redirect -src-parent C:\Windows -src=test.ini -dest-parent __USER_PROFILE_PATH__ -dest test.ini
    frx add-rule -specific-data -src-parent \Registry\Machine\Software -src Value -datatype DWORD -data 42000000
    frx add-rule -vhd-attach -src-parent C:\MyVolFolder -dest C:\VHDs\mydisk.vhd

Обязательные параметры

-src-parent

Родительский каталог или ключ или принтер, к которому применяется правило.

Необязательные параметры

-src

Имя файла или значения

-dest-parent

Каталог назначения или ключ (только правила перенаправления).

-dest

Целевой файл или значение (только правила перенаправления).

-no-copy

Создает пустую копию элемента при перенаправлении, если он не существует (по умолчанию требуется скопировать исходный элемент).

-volatile

Изменяющееся правило, которое не будет сохраняться во время перезагрузки компьютера.

-datatype

Тип определенных данных для возврата (SZ, DWORD).

-data

Шестнадцатеричное представление возвращаемых данных.

Специальные переменные

Доступные для использования параметры или -dest параметры-dest-parent.

Переменная	Description
`__USER_SID__`	Идентификатор безопасности пользователя
`__USER_NAME__`	Имя пользователя
`__USER_PROFILE_PATH__`	Путь к профилю пользователей

frx create-ruleset

Создает набор правил, сканируя указанный каталог установки.

    frx create-ruleset -filename <path>
                       -install-dir <path>
                       -ARP-keyname <path>

Примеры

    frx create-ruleset-name Chrome -install-dir "C:\Program Files\Google\Chrome\Application" -ARP-keyname "HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Google Chrome"

Параметры

-filename

Указывает имя создаваемого файла.

-install-dir

Указывает путь установки приложения для сканирования.

-ARP-keyname

Указывает расположение реестра программы "Добавление и удаление".

frx del-redirect

Удаляет активное перенаправление.

    frx del-redirect -source <path>

Примеры

    frx del-redirect -source C:\MyData\Docs

Параметры

-source

Указывает исходную папку для удаления перенаправления.

frx del-rule

Удалите указанное правило.

    frx del-rule -src-parent <path>
                 -src <path>

Примеры

    frx del-rule -src-parent C:\Windows -src test.ini
    frx del-rule -hide -src-parent \Registry\User\*\Software -src MySoftware

Обязательные параметры

-src-parent

Родительский каталог или ключ, к которому применяется правило.

Необязательные параметры

-src

Имя файла или значения.

frx list-redirects

Выводит список текущих перенаправлений активных папок.

    frx list-redirects

frx list-rules

Перечисляет все правила, загруженные в систему.

    frx list-rules -verbose

Необязательные параметры

-verbose

Отображает дополнительные сведения о правиле.

frx reload-rules

Перезагрузит правила. Может относиться к одному файлу правил или применяться ко всем правилам.

Примечание.

Перезагрузка правил не влияет на изменяющиеся правила.

    frx reload-rules -filename <path>

Примеры

    frx reload-rules -filename Rules.fxr

Необязательные параметры

-filename

Указывает файл правил для перезагрузки.

Профили и виртуальные контейнеры

frx copy-profile

Предупреждение

Если размер локального профиля превышает 5 ГБ, необходимо указать -size-mbs параметр размером более 5000.

Скопируйте профиль пользователя в VHD или VHDX. Если VHD-файл или VHDX не существует, он будет создан.

    frx copy-profile -filename <path>
                     -username <username or domain\username>
                     -sid <sid>
                     -size-mbs <int>
                     -vhdx-sector-size <int>
                     -dynamic <1 or 0>
                     -src-parent <path>
                     -verbose <switch>
                     -profile-path <path>
                     -label <string>
                     -redirections <path>

Примеры

Локальный профиль менее 5 ГБ

    frx copy-profile -filename C:\Profile.vhd -username CONTOSO\msmith

Локальный профиль больше 5 ГБ

    frx copy-profile -filename C:\Profile.vhd -username CONTOSO\msmith -size-mbs 30000

Обязательные параметры

-filename

Указывает путь к файлу VHD(x).

-username

Указано как имя пользователя или домен\имя пользователя

-sid

Используется вместо идентификации -username профиля.

Необязательные параметры

-size-mbs

Размер МБ для нового VHD/VHDX

-vhdx-sector-size

Размер сектора VHDX

-dynamic

Установите значение 1 для динамического, 0 для фиксированного диска

-src-parent

Путь к родительскому VHDX-файлу для разных дисков

-verbose

Включает подробные выходные данные

-profile-path

Указание пути профиля

-label

Метка тома диска (по умолчанию — профиль)

-redirections

Указание файла перенаправления для копирования в профиль

frx copyto-vhd

Копирование папки и его содержимого в VHD или VHDX

    frx copyto-vhd -filename <path>
                   -src <path>
                   -dest <path>
                   -size-mbs <int>
                   -vhdx-sector-size <int>
                   -dynamic <1 or 0>
                   -verbose <switch>
                   -src-parent <path>
                   -label <string>

Примеры

    frx copyto-vhd -filename C:\mydisk.vhd -src C:\data

Обязательные параметры

-filename

Указывает путь к VHDX-файлу

-src

Указывает исходную папку для копирования

Необязательные параметры

-dest

Указывает целевую папку в VHDX-файле. Назначение по умолчанию — корневая папка VHDX.

-size-mbs

Размер МБ для нового VHD/VHDX

-vhdx-sector-size

Размер сектора VHDX

-dynamic

Установите значение 1 для динамического, 0 для фиксированного диска

-verbose

Включает подробные выходные данные

-label

Метка тома диска (по умолчанию — профиль)

frx create-vhd

Создание и форматирование виртуального жесткого диска или VHDX. По умолчанию VHD или VHDX будет иметь 30 ГБИТ/с и размером динамически.

    frx create-vhd -filename <path>
                   -size-mbs <int>
                   -vhdx-sector-size <int>
                   -dynamic <1 or 0>
                   -src-parent <path>
                   -label <string>

Примеры

    frx create-vhd -filename C:\Profile.vhd

Обязательные параметры

-filename

Указывает путь к VHDX-файлу

Необязательные параметры

-size-mbs

Размер МБ для нового VHD/VHDX

-vhdx-sector-size

Размер сектора VHDX

-dynamic

Установите значение 1 для динамического, 0 для фиксированного диска

-src-parent

Путь к родительскому VHDX-файлу для разных дисков

-label

Метка тома диска (по умолчанию — профиль)

frx edit-profile

Присоединяет указанный VHD или VHDX и открывает редактор окна Обозреватель и реестра, чтобы содержимое профиля можно было просматривать и изменять.

    frx edit-profile -filename <path>

Примеры

    frx edit-profile -filename C:\Profile.vhd

Параметры

-filename

Указывает путь к VHDX-файлу

frx begin-edit-profile

Присоединяет указанный VHD или VHDX и присоединяет куст реестра, чтобы содержимое профиля можно было просматривать и изменять.

    frx begin-edit-profile -filename <path>

Примеры

    frx begin-edit-profile -filename C:\Profile.vhd

Параметры

-filename

Указывает путь к VHDX-файлу

frx end-edit-profile

Отсоединяет указанный VHD или VHDX и куст реестра

    frx end-edit-profile -cookie <string>
                         -filename <path>

Примеры

    frx end-edit-profile -cookie 4876 -filename C:\Profile.vhd

Параметры

-cookie

Указывает файл cookie, отпечатанный из вызова профиля начала редактирования.

-filename

Указывает путь к VHDX-файлу

frx export-profilecfg

Экспортирует параметры конфигурации профиля и членство в группе включения и исключения в файл. Параметры можно импортировать позже с помощью команды import-profilecfg.

    frx export-profilecfg -filename <path>

Примеры

    frx export-profilecfg -filename my_configuration.frxconfig

Параметры

-filename

Указывает файл для хранимых данных конфигурации.

frx import-profilecfg

Импортирует параметры конфигурации профиля и членство в группе исключений из файла. Этот файл можно создать с помощью команды export-profilecfg.

    frx import-profilecfg -filename <path>

Примеры

    frx import-profilecfg -filename my_configuration.frxconfig

Параметры

-filename

Указывает файл для хранимых данных конфигурации.

frx migrate-vhd

Создает, форматирует VHD или VHDX и зеркало содержимое исходного виртуального жесткого диска. По умолчанию VHD или VHDX будет иметь 30 ГБИТ/с и размером динамически.

    frx migrate-vhd -src <path>
                    -dest <path>
                    -size-mbs <int>
                    -vhdx-sector-size <int>
                    -dynamic <0 or 1>

Примеры

    frx migrate-vhd -src C:\old\Profile.vhd -dest C:\new\Profile.vhd

Обязательные параметры

-src

Указывает путь к исходному VHDX-файлу

-dest

Указывает новое имя файла VHDX.

Необязательные параметры

-size-mbs

Размер МБ для нового VHD/VHDX

-vhdx-sector-size

Размер сектора VHDX

-dynamic

Установите значение 1 для динамического, 0 для фиксированного диска

frx moveto-vhd

Перемещает папку вместе со всеми вложенными папками и файлами на диск VHD(X).

    frx moveto-vhd -filename <path>
                   -src <path>
                   -dest <path>
                   -size-mbs <int>
                   -vhdx-sector-size <int>
                   -dynamic <1 or 0>
                   -verbose <switch>
                   -src-parent <path>
                   -label <string>

Примеры

    frx moveto-vhd -filename C:\mydisk.vhd -src C:\data

Обязательные параметры

-filename

Указывает путь к VHDX-файлу

-src

Указывает исходную папку для перемещения

Необязательные параметры

-dest

Указывает целевую папку в VHDX-файле. Назначение по умолчанию — корневая папка VHDX.

-size-mbs

Размер МБ для нового VHD/VHDX

-vhdx-sector-size

Размер сектора VHDX

-dynamic

Установите значение 1 для динамического, 0 для фиксированного диска

-verbose

Включает подробные выходные данные

-label

Метка тома диска (по умолчанию — профиль)

frx set-profile-redir

Задает конфигурацию перенаправления папок профиля

    frx set-profile-redir -filename <path>
                          -redirections <path>
                          -no-redirections <switch>

Примеры

    frx set-profile-redir -filename C:\Profile.vhd -redirections C:\redir.xml

Обязательные параметры

-filename

Указывает путь к VHDX-файлу

Необязательные параметры

-redirections

Укажите файл перенаправления для копирования в профиль.

-no-redirections

Удалите все исходящие перенаправления из профиля.

Компонент поиска

frx reset-user-search-db

Повторно индексировать базу данных индекса поиска пользователя.

    frx reset-user-search-db -username <username or domain\username>
                             -sid <sid>

Примеры

    frx reset-user-search-db -username DOMAIN\USERNAME

Параметры

-username

Укажите имя пользователя или домен\имя пользователя.

-sid

Укажите идентификатор безопасности пользователей вместо использования -username

Управление ключами Диспетчера учетных данных

frx add-secure-key

Добавьте безопасный ключ в Диспетчер учетных данных.

    frx add-secure-key -key <string>
                       -value <string>

Примеры

    frx add-secure-key -key fslogix -value secretStringABC123

Параметры

-key

Указывает имя ключа для учетных данных.

-value

Задает значение требуемого ключа.

frx del-secure-key

Удаление безопасного ключа из Диспетчера учетных данных

    frx del-secure-key -key <string>

Примеры

    frx del-secure-key -key fslogix

Параметры

-key

Указывает имя ключа для учетных данных.

frx list-secure-key

Вывод списка ключей, содержащихся в диспетчере учетных данных

    frx list-secure-key

Разное

frx create-junction

Создает точку соединения с целевым томом или папкой

    frx create-junction -src <path>
                        -dest <path>
                        -name <string>

Примеры

    frx create-junction -src E:\ -dest \\Volume{2dd97d8a-3bab-11e1-b9ff-080027e238aa}

Обязательные параметры

-src

Указывает диск или папку, в которой будет добавлена точка соединения.

-dest

Указывает целевую папку или том.

Необязательные параметры

-name

Необязательное отображаемое имя.

frx enable-shnot

Включает уведомление об обновлении оболочки

    frx enable-shnot -true <switch>
                     -false <switch>
                     -force <switch>

Примеры

    frx enable-shnot -force

Необязательные параметры

-true

Включает уведомления

-false

Отключает уведомления

-force

При включении принудительное уведомление вызывает немедленное уведомление.

frx regfont

Регистрирует шрифт в системной таблице шрифтов

    frx regfont -filename <path>

Примеры

    frx regfont -filename C:\myfont.ttf

Параметры

-filename

Указывает путь к файлу шрифта.

frx report-assignment

Отчеты о применимости и неприменимости набора правил путем анализа файла назначения и Active Directory.

    frx report-assignment -filename <path>
                          -username <LDAP>
                          -verbose <switch>
                          -csv <switch>

Примеры

    frx report-assignment -filename C:\test.fxa -username "CN=User,DC=domain"

Обязательные параметры

-filename

Указывает путь к файлу назначения.

Необязательные параметры

-username

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

-verbose

Включает подробные выходные данные.

-csv

Включает выходные данные в формате csv-файла с разделием запятыми.

frx show-junction-info

Отображает сведения о точке соединения в указанной папке.

    frx show-junction-info -src <path>

Примеры

    frx show-junction-info -src E:\

Параметры

-src

Указывает, из какого диска или папки собираются сведения.

frx unregfont

Удаляет шрифт из таблицы системных шрифтов

    frx unregfont -filename <path>

Примеры

    frx unregfont -filename C:\myfont.ttf

Параметры

-filename

Указывает путь к файлу шрифта.

frx start-agent

Запускает все драйверы и службы, состоящие из агента

    frx start-agent

frx stop-agent

Останавливает все драйверы и службы, состоящие из агента

    frx stop-agent

Поделиться через

служебная программа командной строки frx

Команды

Правила

Профили и виртуальные контейнеры

Компонент поиска

Управление ключами Диспетчера учетных данных

Разное

версия frx

Примеры

Правила

frx add-redirect

Обязательные параметры

Примеры

frx add-rule

Примеры

Обязательные параметры

Необязательные параметры

Специальные переменные

frx create-ruleset

Примеры

Параметры

frx del-redirect

Примеры

Параметры

frx del-rule

Примеры

Обязательные параметры

Необязательные параметры

frx list-redirects

frx list-rules

Необязательные параметры

frx reload-rules

Примеры

Необязательные параметры

Профили и виртуальные контейнеры

frx copy-profile

Примеры

Обязательные параметры

Необязательные параметры

frx copyto-vhd

Примеры

Обязательные параметры

Необязательные параметры

frx create-vhd

Примеры

Обязательные параметры

Необязательные параметры

frx edit-profile

Примеры

Параметры

frx begin-edit-profile

Примеры

Параметры

frx end-edit-profile

Примеры

Параметры

frx export-profilecfg

Примеры

Параметры

frx import-profilecfg

Примеры

Параметры

frx migrate-vhd

Примеры

Обязательные параметры

Необязательные параметры

frx moveto-vhd

Примеры

Обязательные параметры

Необязательные параметры

frx set-profile-redir

Примеры

Обязательные параметры

Необязательные параметры

Компонент поиска

frx reset-user-search-db

Примеры

Параметры

Управление ключами Диспетчера учетных данных