служебная программа командной строки frx
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