utilidad de línea de comandos frx

Artículo
05/20/2023

frx es una utilidad de línea de comandos que proporciona administración y configuración de una configuración de FSLogix. La utilidad administra reglas, perfiles y contenedores, búsqueda, administrador de credenciales y otras funciones diversas.

Comandos

Command	Descripción
¿Ayuda?	Mostrar este mensaje de ayuda
version	Mostrar las versiones de los componentes cargados

Reglas

Comando	Descripción
add-redirect	Adición de una nueva redirección de carpetas
add-rule	Adición de la regla especificada
create-ruleset	Crea un conjunto de reglas
del-redirect	Eliminación de un redireccionamiento de carpetas activas
del-rule	Eliminación de la regla especificada
redireccionamientos de lista	Enumeración de redirecciones de carpetas activas actualmente
list-rules	Enumerar reglas cargadas actualmente
reglas de recarga	Volver a cargar reglas de la memoria caché

Perfiles y contenedores virtuales

Comando	Descripción
copy-profile	Copiar el perfil de un usuario en un VHD o VHDX
copyto-vhd	Copia de una carpeta y su contenido en un VHD o VHDX
create-vhd	Creación y formato de un VHD o VHDX
edit-profile	Edición del contenido del perfil contenido en un VHD o VHDX
begin-edit-profile	Asocia el VHD o VHDX especificado y el subárbol del Registro
end-edit-profile	Desasocia el VHD o VHDX especificado y el subárbol del Registro
export-profilecfg	Exportar opciones de configuración de perfil al archivo
import-profilecfg	Importar opciones de configuración de perfil desde el archivo
migrate-vhd	Migra el contenido de un disco duro virtual existente a uno nuevo.
moveto-vhd	Mover una carpeta y su contenido a un VHD o VHDX
set-profile-redir	Establece la configuración de redirecciones de carpetas del perfil

Componente de búsqueda

Comando	Descripción
reset-user-search-db	Vuelva a indexar la base de datos de índice de búsqueda de un usuario.

Administración de claves del Administrador de credenciales

Comando	Descripción
add-secure-key	Adición de una clave segura al Administrador de credenciales
del-secure-key	Eliminación de una clave segura del Administrador de credenciales
list-secure-key	enumerar las claves contenidas en el Administrador de credenciales

Varios

Comando	Descripción
create-junction	Crea un punto de unión a un volumen o carpeta de destino.
enable-shnot	Habilita la notificación de actualización del shell
regfont	Registra una fuente en la tabla de fuentes del sistema
asignación de informes	Informes de aplicabilidad del conjunto de reglas
show-junction-info	Muestra información sobre un punto de unión
unregfont	Quita una fuente de la tabla de fuentes del sistema.
start-agent	Inicia todos los controladores y servicios que componen el agente.
stop-agent	Detiene todos los controladores y servicios que componen el agente.

versión frx

Muestra las versiones de los componentes cargados

Ejemplos

    frx version

Reglas

frx add-redirect

Adición de un nuevo redireccionamiento de ruta de acceso para el controlador de virtualización

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

Parámetros requeridos

-source o -src

Especifica la ruta de acceso de origen que se va a redirigir.

-destination o -dest

Especifica la ruta de acceso que se va a actuar como destino de redireccionamiento.

Ejemplos

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

frx add-rule

Agregue una regla específica.

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

Ejemplos

    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

Parámetros requeridos

-src-parent

Directorio principal o clave o impresora a la que se aplica la regla.

Parámetros opcionales

-src

Nombre de archivo o valor

-dest-parent

Directorio o clave de destino (solo reglas de redireccionamiento).

-dest

Archivo o valor de destino (solo reglas de redireccionamiento).

-no-copy

Crea una copia en blanco del elemento tras la redirección si no existe (el valor predeterminado es copiar el elemento de origen).

-volatile

Regla volátil que no se conservará en un reinicio de la máquina.

-datatype

Tipo de datos específicos que se van a devolver (SZ, DWORD).

-data

Representación hexadecimal de los datos que se van a devolver.

Variables especiales

Se puede usar en -dest-parent parámetros o -dest .

Variable	Descripción
`__USER_SID__`	SID del usuario
`__USER_NAME__`	Nombre de usuario del usuario
`__USER_PROFILE_PATH__`	Ruta de acceso al perfil de usuarios

frx create-ruleset

Crea un conjunto de reglas examinando el directorio de instalación especificado.

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

Ejemplos

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

Parámetros

-filename

Especifica el nombre del archivo que se va a crear.

-install-dir

Especifica la ruta de instalación de la aplicación que se va a examinar.

-ARP-keyname

Especifica la ubicación del Registro agregar o quitar programa.

frx del-redirect

Elimina un redireccionamiento activo.

    frx del-redirect -source <path>

Ejemplos

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

Parámetros

-source

Especifica la carpeta de origen de la que se va a quitar el redireccionamiento.

frx del-rule

Elimine la regla especificada.

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

Ejemplos

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

Parámetros requeridos

-src-parent

Directorio principal o clave a la que se aplica la regla.

Parámetros opcionales

-src

Nombre de archivo o valor.

frx list-redirects

Enumera las redirecciones de carpetas activas actuales.

    frx list-redirects

frx list-rules

Enumera todas las reglas cargadas en el sistema.

    frx list-rules -verbose

Parámetros opcionales

-verbose

Muestra información adicional sobre la regla.

frx reload-rules

Vuelve a cargar las reglas. Puede ser específico de un archivo de reglas o aplicar a todas las reglas.

Nota:

Las reglas de recarga no afectan a las reglas volátiles.

    frx reload-rules -filename <path>

Ejemplos

    frx reload-rules -filename Rules.fxr

Parámetros opcionales

-filename

Especifica el archivo de reglas que se va a volver a cargar.

Perfiles y contenedores virtuales

frx copy-profile

Advertencia

Si el tamaño del perfil local supera los 5 GB, debe especificar el -size-mbs parámetro con un tamaño mayor que 5000.

Copie el perfil de un usuario en un VHD o VHDX. Si el archivo VHD o VHDX no existe, se creará.

    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>

Ejemplos

Perfil local inferior a 5 GB

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

Perfil local mayor que 5 GB

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

Parámetros requeridos

-filename

Especifica la ruta de acceso al archivo VHD(x).

-username

Especificado como nombre de usuario o DOMINIO\Nombre de usuario

-sid

Se usa en lugar de -username para identificar el perfil.

Parámetros opcionales

-size-mbs

Tamaño en el número de MB para un nuevo VHD/VHDX

-vhdx-sector-size

Tamaño del sector VHDX

-dynamic

Establézcalo en 1 para dinámico, 0 para disco fijo

-src-parent

Ruta de acceso al archivo VHDX primario para discos de diferenciación

-verbose

Habilita la salida detallada

-profile-path

Especificar la ruta de acceso del perfil

-label

Etiqueta de volumen de disco (el valor predeterminado es Perfil)

-redirections

Especificar el archivo de redireccionamientos que se va a copiar en el perfil

frx copyto-vhd

Copia de una carpeta y su contenido en un VHD o 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>

Ejemplos

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

Parámetros requeridos

-filename

Especifica la ruta de acceso al archivo VHDX.

-src

Especifica la carpeta de origen que se va a copiar.

Parámetros opcionales

-dest

Especifica la carpeta de destino en el archivo VHDX. El destino predeterminado es la carpeta raíz VHDX.

-size-mbs

Tamaño en el número de MB para un nuevo VHD/VHDX

-vhdx-sector-size

Tamaño del sector VHDX

-dynamic

Establézcalo en 1 para dinámico, 0 para disco fijo

-verbose

Habilita la salida detallada

-label

Etiqueta de volumen de disco (el valor predeterminado es Perfil)

frx create-vhd

Cree y dé formato a un VHD o VHDX. De forma predeterminada, el VHD o VHDX tendrá un tamaño dinámico de 30 GB.

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

Ejemplos

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

Parámetros requeridos

-filename

Especifica la ruta de acceso al archivo VHDX.

Parámetros opcionales

-size-mbs

Tamaño en el número de MB para un nuevo VHD/VHDX

-vhdx-sector-size

Tamaño del sector VHDX

-dynamic

Establézcalo en 1 para dinámico, 0 para disco fijo

-src-parent

Ruta de acceso al archivo VHDX primario para discos de diferenciación

-label

Etiqueta de volumen de disco (el valor predeterminado es Perfil)

frx edit-profile

Adjunta el VHD o VHDX especificados y abre una ventana del Explorador y un editor del Registro para que el contenido del perfil se pueda ver y editar.

    frx edit-profile -filename <path>

Ejemplos

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

Parámetros

-filename

Especifica la ruta de acceso al archivo VHDX.

frx begin-edit-profile

Asocia el VHD o VHDX especificado y adjunta el subárbol del Registro para que el contenido del perfil se pueda ver y editar.

    frx begin-edit-profile -filename <path>

Ejemplos

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

Parámetros

-filename

Especifica la ruta de acceso al archivo VHDX.

frx end-edit-profile

Desasocia el VHD o VHDX especificado y el subárbol del Registro

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

Ejemplos

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

Parámetros

-cookie

Especifica la cookie impresa desde la llamada begin-edit-profile.

-filename

Especifica la ruta de acceso al archivo VHDX.

frx export-profilecfg

Exporta las opciones de configuración del perfil y la pertenencia a grupos de inclusión o exclusión a un archivo. La configuración se puede importar más adelante con el comando import-profilecfg.

    frx export-profilecfg -filename <path>

Ejemplos

    frx export-profilecfg -filename my_configuration.frxconfig

Parámetros

-filename

Especifica el archivo para que se almacenen los datos de configuración.

frx import-profilecfg

Importa los valores de configuración de perfil y la pertenencia a grupos de inclusión o exclusión del archivo. Este archivo se puede generar con el comando export-profilecfg.

    frx import-profilecfg -filename <path>

Ejemplos

    frx import-profilecfg -filename my_configuration.frxconfig

Parámetros

-filename

Especifica el archivo para que se almacenen los datos de configuración.

frx migrate-vhd

Crea, da formato a un VHD o VHDX y refleja el contenido del VHD de origen. De forma predeterminada, el VHD o VHDX tendrá un tamaño dinámico de 30 GB.

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

Ejemplos

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

Parámetros requeridos

-src

Especifica la ruta de acceso al archivo VHDX de origen.

-dest

Especifica el nuevo nombre de archivo VHDX.

Parámetros opcionales

-size-mbs

Tamaño en el número de MB para un nuevo VHD/VHDX

-vhdx-sector-size

Tamaño del sector VHDX

-dynamic

Establézcalo en 1 para dinámico, 0 para disco fijo

frx moveto-vhd

Mueve una carpeta junto con todas sus subcarpetas y archivos a un disco 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>

Ejemplos

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

Parámetros requeridos

-filename

Especifica la ruta de acceso al archivo VHDX.

-src

Especifica la carpeta de origen que se va a mover.

Parámetros opcionales

-dest

Especifica la carpeta de destino en el archivo VHDX. El destino predeterminado es la carpeta raíz VHDX.

-size-mbs

Tamaño en el número de MB para un nuevo VHD/VHDX

-vhdx-sector-size

Tamaño del sector VHDX

-dynamic

Establézcalo en 1 para dinámico, 0 para disco fijo

-verbose

Habilita la salida detallada

-label

Etiqueta de volumen de disco (el valor predeterminado es Perfil)

frx set-profile-redir

Establece la configuración de redirecciones de carpetas del perfil

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

Ejemplos

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

Parámetros requeridos

-filename

Especifica la ruta de acceso al archivo VHDX.

Parámetros opcionales

-redirections

Especifique el archivo de redireccionamientos que se va a copiar en el perfil.

-no-redirections

Quite las redirecciones de salida del perfil.

Componente de búsqueda

frx reset-user-search-db

Vuelva a indexar la base de datos de índice de búsqueda de un usuario.

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

Ejemplos

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

Parámetros

-username

Especifique username o DOMAIN\username.

-sid

Especificar el SID de los usuarios en lugar de usar -username

Administración de claves del Administrador de credenciales

frx add-secure-key

Agregue una clave segura al Administrador de credenciales.

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

Ejemplos

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

Parámetros

-key

Especifica el nombre de clave de la credencial.

-value

Especifica el valor de la clave deseada.

frx del-secure-key

Eliminación de una clave segura del Administrador de credenciales

    frx del-secure-key -key <string>

Ejemplos

    frx del-secure-key -key fslogix

Parámetros

-key

Especifica el nombre de clave de la credencial.

frx list-secure-key

Enumerar las claves contenidas en el Administrador de credenciales

    frx list-secure-key

Varios

frx create-junction

Crea un punto de unión a un volumen o carpeta de destino.

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

Ejemplos

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

Parámetros requeridos

-src

Especifica la unidad o carpeta donde se agregará el punto de unión.

-dest

Especifica la carpeta o el volumen de destino.

Parámetros opcionales

-name

Nombre para mostrar opcional.

frx enable-shnot

Habilita la notificación de actualización del shell

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

Ejemplos

    frx enable-shnot -force

Parámetros opcionales

-true

Habilita las notificaciones

-false

Deshabilita las notificaciones

-force

Fuerza la notificación inmediata si está habilitada.

frx regfont

Registra una fuente en la tabla de fuentes del sistema

    frx regfont -filename <path>

Ejemplos

    frx regfont -filename C:\myfont.ttf

Parámetros

-filename

Especifica la ruta de acceso al archivo de fuente.

frx report-assignment

Informa sobre la aplicabilidad y la no aplicabilidad de un conjunto de reglas mediante el análisis del archivo de asignación y Active Directory.

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

Ejemplos

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

Parámetros requeridos

-filename

Especifica la ruta de acceso al archivo de asignación.

Parámetros opcionales

-username

Informa de la aplicabilidad del archivo de asignación para el usuario especificado (nombre distintivo).

-verbose

Habilita la salda detallada.

-csv

Habilita la salida en formato de valor separado por comas (CSV).

frx show-junction-info

Muestra información de punto de unión en la carpeta especificada.

    frx show-junction-info -src <path>

Ejemplos

    frx show-junction-info -src E:\

Parámetros

-src

Especifica de la unidad o carpeta de la que se recopila la información.

frx unregfont

Quita una fuente de la tabla de fuentes del sistema.

    frx unregfont -filename <path>

Ejemplos

    frx unregfont -filename C:\myfont.ttf

Parámetros

-filename

Especifica la ruta de acceso al archivo de fuente.

frx start-agent

Inicia todos los controladores y servicios que componen el agente.

    frx start-agent

frx stop-agent

Detiene todos los controladores y servicios que componen el agente.

    frx stop-agent

Share via

utilidad de línea de comandos frx

Comandos

Reglas

Perfiles y contenedores virtuales

Componente de búsqueda

Administración de claves del Administrador de credenciales

Varios

versión frx

Ejemplos

Reglas

frx add-redirect

Parámetros requeridos

Ejemplos

frx add-rule

Ejemplos

Parámetros requeridos

Parámetros opcionales

Variables especiales

frx create-ruleset

Ejemplos

Parámetros

frx del-redirect

Ejemplos

Parámetros

frx del-rule

Ejemplos

Parámetros requeridos

Parámetros opcionales

frx list-redirects

frx list-rules

Parámetros opcionales

frx reload-rules

Ejemplos

Parámetros opcionales

Perfiles y contenedores virtuales

frx copy-profile

Ejemplos

Parámetros requeridos

Parámetros opcionales

frx copyto-vhd

Ejemplos

Parámetros requeridos

Parámetros opcionales

frx create-vhd

Ejemplos

Parámetros requeridos

Parámetros opcionales

frx edit-profile

Ejemplos

Parámetros

frx begin-edit-profile

Ejemplos

Parámetros

frx end-edit-profile

Ejemplos

Parámetros

frx export-profilecfg

Ejemplos

Parámetros

frx import-profilecfg

Ejemplos

Parámetros

frx migrate-vhd

Ejemplos

Parámetros requeridos

Parámetros opcionales

frx moveto-vhd

Ejemplos

Parámetros requeridos

Parámetros opcionales

frx set-profile-redir

Ejemplos

Parámetros requeridos

Parámetros opcionales

Componente de búsqueda

frx reset-user-search-db

Ejemplos

Parámetros

Administración de claves del Administrador de credenciales