utilitaire de ligne de commande frx

Article
11/10/2023

frx est un utilitaire de ligne de commande qui fournit la gestion et la configuration d’une configuration FSLogix. L’utilitaire gère les règles, les profils et les conteneurs, la recherche, le gestionnaire d’informations d’identification et d’autres fonctions diverses.

Commandes

Command	Description
Aide?	Afficher ce message d’aide
version	Afficher les versions des composants chargés

Règles

Commande	Description
add-redirect	Ajouter une nouvelle redirection de dossiers
add-rule	Ajouter la règle spécifiée
create-ruleset	Crée un ensemble de règles
del-redirect	Supprimer une redirection de dossiers actifs
del-rule	Supprimer la règle spécifiée
redirections de liste	Répertorier les redirections de dossiers actuellement actives
list-rules	Répertorier les règles actuellement chargées
reload-rules	Recharger des règles à partir du cache

Profils et conteneurs virtuels

Commande	Description
copy-profile	Copier le profil d’un utilisateur dans un disque dur virtuel ou VHDX
copyto-vhd	Copier un dossier et son contenu dans un disque dur virtuel ou VHDX
create-vhd	Créer et mettre en forme un disque dur virtuel ou un VHDX
edit-profile	Modifier le contenu du profil contenu dans un disque dur virtuel ou VHDX
begin-edit-profile	Attache le disque dur virtuel ou VHDX spécifié et la ruche de Registre
end-edit-profile	Détache le disque dur virtuel ou VHDX spécifié et la ruche de Registre
export-profilecfg	Exporter les paramètres de configuration de profil dans un fichier
import-profilecfg	Importer des paramètres de configuration de profil à partir d’un fichier
migrate-vhd	Migre le contenu d’un disque dur virtuel existant vers un nouveau disque dur virtuel
moveto-vhd	Déplacer un dossier et son contenu vers un disque dur virtuel ou VHDX
set-profile-redir	Définit la configuration des redirections de dossiers du profil

Composant de recherche

Commande	Description
reset-user-search-db	Réindexez la base de données d’index de recherche d’un utilisateur.

Gestion des clés du Gestionnaire d’informations d’identification

Commande	Description
add-secure-key	Ajouter une clé sécurisée au Gestionnaire d’informations d’identification
del-secure-key	Supprimer une clé sécurisée du Gestionnaire d’informations d’identification
list-secure-key	répertorier les clés contenues dans le Gestionnaire d’informations d’identification

Divers

Commande	Description
create-junction	Crée un point de jonction vers un volume ou un dossier cible
enable-shnot	Active la notification d’actualisation de l’interpréteur de commandes
regfont	Inscrit une police dans la table de polices système
affectation de rapport	Rapports d’applicabilité de l’ensemble de règles
show-junction-info	Affiche des informations sur un point de jonction
unregfont	Supprime une police de la table de polices système
start-agent	Démarre tous les pilotes et services comprenant l’agent
stop-agent	Arrête tous les pilotes et services comprenant l’agent

version frx

Affiche les versions des composants chargés

Exemples

    frx version

Règles

frx add-redirect

Ajouter une nouvelle redirection de chemin d’accès pour le pilote de virtualisation

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

Paramètres obligatoires

-source ou -src

Spécifie le chemin d’accès source à rediriger.

-destination ou -dest

Spécifie le chemin d’accès à agir comme cible de redirection.

Exemples

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

frx add-rule

Ajoutez une règle spécifique.

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

Exemples

    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

Paramètres obligatoires

-src-parent

Répertoire/clé parent ou imprimante auquel la règle s’applique.

Paramètres facultatifs

-src

Nom du fichier ou de la valeur

-dest-parent

Répertoire de destination ou clé (règles de redirection uniquement).

-dest

Fichier ou valeur de destination (règles de redirection uniquement).

-no-copy

Crée une copie vide de l’élément lors de la redirection s’il n’existe pas (la valeur par défaut consiste à copier l’élément source).

-volatile

Règle volatile qui ne persistera pas sur un redémarrage de l’ordinateur.

-datatype

Type de données spécifiques à retourner (SZ, DWORD).

-data

Représentation hexadécimale des données à retourner.

Variables spéciales

Utilisable dans ou -dest paramètres-dest-parent.

Variable	Description
`__USER_SID__`	SID de l’utilisateur
`__USER_NAME__`	Nom d’utilisateur de l’utilisateur
`__USER_PROFILE_PATH__`	Chemin d’accès au profil des utilisateurs

frx create-ruleset

Crée un jeu de règles en analysant le répertoire d’installation spécifié.

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

Exemples

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

Paramètres

-filename

Spécifie le nom du fichier à créer.

-install-dir

Spécifie le chemin d’installation de l’application à analyser.

-ARP-keyname

Spécifie l’emplacement du Registre d’ajout/suppression du programme.

frx del-redirect

Supprime une redirection active.

    frx del-redirect -source <path>

Exemples

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

Paramètres

-source

Spécifie le dossier source à partir duquel supprimer la redirection.

frx del-rule

Supprimez la règle spécifiée.

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

Exemples

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

Paramètres obligatoires

-src-parent

Répertoire parent ou clé auquel la règle s’applique.

Paramètres facultatifs

-src

Nom du fichier ou de la valeur.

frx list-redirects

Répertorie les redirections de dossiers actifs actuelles.

    frx list-redirects

frx list-rules

Répertorie toutes les règles chargées dans le système.

    frx list-rules -verbose

Paramètres facultatifs

-verbose

Affiche des informations supplémentaires sur la règle.

frx reload-rules

Recharge les règles. Peut être spécifique à un fichier de règles ou s’appliquer à toutes les règles.

Remarque

Les règles de rechargement n’ont aucun impact sur les règles volatiles.

    frx reload-rules -filename <path>

Exemples

    frx reload-rules -filename Rules.fxr

Paramètres facultatifs

-filename

Spécifie le fichier de règles à recharger.

Profils et conteneurs virtuels

frx copy-profile

Avertissement

Si la taille du profil local dépasse 5 Go, vous devez spécifier le paramètre dont la -size-mbs taille est supérieure à 5 000.

Copiez le profil d’un utilisateur dans un disque dur virtuel ou VHDX. Si le fichier VHD ou VHDX n’existe pas, il est créé.

    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>

Exemples

Profil local inférieur à 5 Go

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

Profil local supérieur à 5 Go

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

Paramètres obligatoires

-filename

Spécifie le chemin d’accès au fichier VHD(x).

-username

Spécifié en tant que nom d’utilisateur ou domaine\nom d’utilisateur

-sid

Utilisé à la place de l’identification -username du profil.

Paramètres facultatifs

-size-mbs

Taille en nombre de Mo pour le nouveau disque dur virtuel/VHDX

-vhdx-sector-size

Taille du secteur VHDX

-dynamic

Défini sur 1 pour le disque fixe, 0 pour le disque fixe

-src-parent

Chemin d’accès au fichier VHDX parent pour les disques de différenciation

-verbose

Active la sortie détaillée

-profile-path

Spécifier le chemin d’accès au profil

-label

Étiquette de volume de disque (profil par défaut)

-redirections

Spécifier le fichier de redirections à copier vers le profil

frx copyto-vhd

Copier un dossier et son contenu dans un disque dur virtuel ou 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>

Exemples

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

Paramètres obligatoires

-filename

Spécifie le chemin d’accès au fichier VHDX

-src

Spécifie le dossier source à copier

Paramètres facultatifs

-dest

Spécifie le dossier cible dans le fichier VHDX. La destination par défaut est le dossier racine VHDX.

-size-mbs

Taille en nombre de Mo pour le nouveau disque dur virtuel/VHDX

-vhdx-sector-size

Taille du secteur VHDX

-dynamic

Défini sur 1 pour le disque fixe, 0 pour le disque fixe

-verbose

Active la sortie détaillée

-label

Étiquette de volume de disque (profil par défaut)

frx create-vhd

Créez et mettez en forme un disque dur virtuel ou un VHDX. Par défaut, le disque dur virtuel ou VHDX est de 30 GB et dimensionné dynamiquement.

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

Exemples

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

Paramètres obligatoires

-filename

Spécifie le chemin d’accès au fichier VHDX

Paramètres facultatifs

-size-mbs

Taille en nombre de Mo pour le nouveau disque dur virtuel/VHDX

-vhdx-sector-size

Taille du secteur VHDX

-dynamic

Défini sur 1 pour le disque fixe, 0 pour le disque fixe

-src-parent

Chemin d’accès au fichier VHDX parent pour les disques de différenciation

-label

Étiquette de volume de disque (profil par défaut)

frx edit-profile

Attache le disque dur virtuel ou VHDX spécifié et ouvre une fenêtre d’Explorateur et un éditeur de Registre afin que le contenu du profil puisse être consulté et modifié.

    frx edit-profile -filename <path>

Exemples

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

Paramètres

-filename

Spécifie le chemin d’accès au fichier VHDX

frx begin-edit-profile

Attache le disque dur virtuel ou VHDX spécifié et attache la ruche de Registre afin que le contenu du profil puisse être consulté et modifié.

    frx begin-edit-profile -filename <path>

Exemples

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

Paramètres

-filename

Spécifie le chemin d’accès au fichier VHDX

frx end-edit-profile

Détache le disque dur virtuel ou VHDX spécifié et la ruche de Registre

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

Exemples

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

Paramètres

-cookie

Spécifie le cookie imprimé à partir de l’appel begin-edit-profile.

-filename

Spécifie le chemin d’accès au fichier VHDX

frx export-profilecfg

Exporte les paramètres de configuration de profil et l’appartenance au groupe d’inclusion/exclusion dans un fichier. Les paramètres peuvent être importés ultérieurement avec la commande import-profilecfg.

    frx export-profilecfg -filename <path>

Exemples

    frx export-profilecfg -filename my_configuration.frxconfig

Paramètres

-filename

Spécifie le fichier des données de configuration à stocker.

frx import-profilecfg

Importe les paramètres de configuration de profil et l’appartenance au groupe d’inclusion/exclusion à partir du fichier. Ce fichier peut être généré avec la commande export-profilecfg.

    frx import-profilecfg -filename <path>

Exemples

    frx import-profilecfg -filename my_configuration.frxconfig

Paramètres

-filename

Spécifie le fichier des données de configuration à stocker.

frx migrate-vhd

Crée, met en forme un disque dur virtuel ou VHDX et miroir le contenu du disque dur virtuel source. Par défaut, le disque dur virtuel ou VHDX est de 30 GB et dimensionné dynamiquement.

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

Exemples

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

Paramètres obligatoires

-src

Spécifie le chemin d’accès au fichier VHDX source

-dest

Spécifie le nouveau nom de fichier VHDX.

Paramètres facultatifs

-size-mbs

Taille en nombre de Mo pour le nouveau disque dur virtuel/VHDX

-vhdx-sector-size

Taille du secteur VHDX

-dynamic

Défini sur 1 pour le disque fixe, 0 pour le disque fixe

frx moveto-vhd

Déplace un dossier avec tous ses sous-dossiers et fichiers vers un disque 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>

Exemples

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

Paramètres obligatoires

-filename

Spécifie le chemin d’accès au fichier VHDX

-src

Spécifie le dossier source à déplacer

Paramètres facultatifs

-dest

Spécifie le dossier cible dans le fichier VHDX. La destination par défaut est le dossier racine VHDX.

-size-mbs

Taille en nombre de Mo pour le nouveau disque dur virtuel/VHDX

-vhdx-sector-size

Taille du secteur VHDX

-dynamic

Défini sur 1 pour le disque fixe, 0 pour le disque fixe

-verbose

Active la sortie détaillée

-label

Étiquette de volume de disque (profil par défaut)

frx set-profile-redir

Définit la configuration des redirections de dossiers du profil

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

Exemples

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

Paramètres obligatoires

-filename

Spécifie le chemin d’accès au fichier VHDX

Paramètres facultatifs

-redirections

Spécifiez le fichier de redirections à copier vers le profil.

-no-redirections

Supprimez les redirections sortantes du profil.

Composant de recherche

frx reset-user-search-db

Réindexer la base de données d’index de recherche d’un utilisateur.

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

Exemples

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

Paramètres

-username

Spécifiez le nom d’utilisateur ou DOMAIN\username.

-sid

Spécifier le SID des utilisateurs au lieu d’utiliser -username

Gestion des clés du Gestionnaire d’informations d’identification

frx add-secure-key

Ajoutez une clé sécurisée au Gestionnaire d’informations d’identification.

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

Exemples

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

Paramètres

-key

Spécifie le nom de clé des informations d’identification.

-value

Spécifie la valeur de la clé souhaitée.

frx del-secure-key

Supprimer une clé sécurisée du Gestionnaire d’informations d’identification

    frx del-secure-key -key <string>

Exemples

    frx del-secure-key -key fslogix

Paramètres

-key

Spécifie le nom de clé des informations d’identification.

frx list-secure-key

Répertorier les clés contenues dans le Gestionnaire d’informations d’identification

    frx list-secure-key

Divers

frx create-junction

Crée un point de jonction vers un volume ou un dossier cible

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

Exemples

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

Paramètres obligatoires

-src

Spécifie le lecteur ou le dossier dans lequel le point de jonction sera ajouté.

-dest

Spécifie le dossier ou le volume cible.

Paramètres facultatifs

-name

Nom complet facultatif.

frx enable-shnot

Active la notification d’actualisation de l’interpréteur de commandes

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

Exemples

    frx enable-shnot -force

Paramètres facultatifs

-true

Active les notifications

-false

Désactive les notifications

-force

Force la notification immédiate si elle est activée.

frx regfont

Inscrit une police dans la table de polices système

    frx regfont -filename <path>

Exemples

    frx regfont -filename C:\myfont.ttf

Paramètres

-filename

Spécifie le chemin d’accès au fichier de police.

frx report-assignment

Signale l’applicabilité et la non-applicabilité d’un ensemble de règles en analysant le fichier d’affectation et Active Directory.

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

Exemples

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

Paramètres obligatoires

-filename

Spécifie le chemin d’accès au fichier d’affectation.

Paramètres facultatifs

-username

Signale l’applicabilité du fichier d’affectation pour l’utilisateur spécifié (nom unique).

-verbose

Active la sortie détaillée.

-csv

Active la sortie au format CSV (Valeur séparée par des virgules).

frx show-junction-info

Affiche les informations de point de jonction sur le dossier spécifié.

    frx show-junction-info -src <path>

Exemples

    frx show-junction-info -src E:\

Paramètres

-src

Spécifie le lecteur ou le dossier à partir duquel les informations sont collectées.

frx unregfont

Supprime une police de la table de polices système

    frx unregfont -filename <path>

Exemples

    frx unregfont -filename C:\myfont.ttf

Paramètres

-filename

Spécifie le chemin d’accès au fichier de police.

frx start-agent

Démarre tous les pilotes et services comprenant l’agent

    frx start-agent

frx stop-agent

Arrête tous les pilotes et services comprenant l’agent

    frx stop-agent

Share via

utilitaire de ligne de commande frx

Commandes

Règles

Profils et conteneurs virtuels

Composant de recherche

Gestion des clés du Gestionnaire d’informations d’identification

Divers

version frx

Exemples

Règles

frx add-redirect

Paramètres obligatoires

Exemples

frx add-rule

Exemples

Paramètres obligatoires

Paramètres facultatifs

Variables spéciales

frx create-ruleset

Exemples

Paramètres

frx del-redirect

Exemples

Paramètres

frx del-rule

Exemples

Paramètres obligatoires

Paramètres facultatifs

frx list-redirects

frx list-rules

Paramètres facultatifs

frx reload-rules

Exemples

Paramètres facultatifs

Profils et conteneurs virtuels

frx copy-profile

Exemples

Paramètres obligatoires

Paramètres facultatifs

frx copyto-vhd

Exemples

Paramètres obligatoires

Paramètres facultatifs

frx create-vhd

Exemples

Paramètres obligatoires

Paramètres facultatifs

frx edit-profile

Exemples

Paramètres

frx begin-edit-profile

Exemples

Paramètres

frx end-edit-profile

Exemples

Paramètres

frx export-profilecfg

Exemples

Paramètres

frx import-profilecfg

Exemples

Paramètres

frx migrate-vhd

Exemples

Paramètres obligatoires

Paramètres facultatifs

frx moveto-vhd

Exemples

Paramètres obligatoires

Paramètres facultatifs

frx set-profile-redir

Exemples

Paramètres obligatoires

Paramètres facultatifs

Composant de recherche

frx reset-user-search-db

Exemples

Paramètres

Gestion des clés du Gestionnaire d’informations d’identification