frx-Befehlszeilenprogramm

Artikel
01/22/2024

Frx ist ein Befehlszeilenhilfsprogramm, das die Verwaltung und Konfiguration einer FSLogix-Konfiguration bereitstellt. Das Hilfsprogramm verwaltet Regeln, Profile und Container, Suche, Anmeldeinformationsverwaltung und andere verschiedene Funktionen.

Befehle

Befehl	Beschreibung
help, ?	Anzeigen dieser Hilfemeldung
Version	Anzeigen der Versionen der geladenen Komponenten

Regeln

Befehl	Beschreibung
add-redirect	Hinzufügen einer neuen Ordnerumleitung
add-rule	Hinzufügen der angegebenen Regel
create-ruleset	Erstellen eines Regelsatzes
del-redirect	Löschen einer aktiven Ordnerumleitung
del-rule	Löschen der angegebenen Regel
list-redirects	Auflisten der derzeit aktiven Ordnerumleitungen
list-rules	Auflisten aktuell geladener Regeln
reload-rules	Erneutes Laden von Regeln aus dem Cache

Profile und virtuelle Container

Befehl	Beschreibung
copy-profile	Kopieren eines Benutzerprofils in eine VHD oder VHDX
copyto-vhd	Kopieren eines Ordners und seiner Inhalte in eine VHD oder VHDX
create-vhd	Erstellen und Formatieren einer VHD oder VHDX
edit-profile	Bearbeiten von Profilinhalten in einer VHD oder VHDX
begin-edit-profile	Anfügen der angegebenen VHD oder VHDX und der Registrierungsstruktur
end-edit-profile	Trennen der angegebenen VHD oder VHDX und der Registrierungsstruktur
export-profilecfg	Exportieren von Profilkonfigurationseinstellungen in eine Datei
import-profilecfg	Importieren von Profilkonfigurationseinstellungen aus einer Datei
migrate-vhd	Migrieren des Inhalts einer vorhandenen VHD in eine neue VHD
moveto-vhd	Verschieben eines Ordners und seiner Inhalte in eine VHD oder VHDX
set-profile-redir	Festlegen der Konfiguration der Ordnerumleitungen für Profilordner

Suche nach Komponenten

Befehl	Beschreibung
reset-user-search-db	Erneutes Indizieren der Suchindexdatenbank von Benutzer*innen

Schlüsselverwaltung für Anmeldeinformationsverwaltung

Befehl	Beschreibung
add-secure-key	Hinzufügen eines sicheren Schlüssels zur Anmeldeinformationsverwaltung
del-secure-key	Löschen eines sicheren Schlüssels aus der Anmeldeinformationsverwaltung
list-secure-key	Auflisten der in der Anmeldeinformationsverwaltung enthaltenen Schlüssel

Sonstiges

Befehl	Beschreibung
create-junction	Erstellen eines Verknüpfungspunkts zu einem Zielvolume oder -verzeichnis
enable-shnot	Aktivieren von Benachrichtigungen bei Aktualisierungen der Shell
regfont	Registrieren einer Schriftart in der Systemschriftarttabelle
report-assignment	Anwendbarkeitsberichterstellung für Regelsatz
show-junction-info	Zeigt Informationen über einen Verknüpfungspunkt an.
unregfont	Entfernen einer Schriftart aus der Systemschriftarttabelle
start-agent	Starten aller Treiber und Dienste, die den Agent umfassen
stop-agent	Beenden alle Treiber und Dienste, die den Agent umfassen

frx version

Anzeigen der Versionen der geladenen Komponenten

Beispiele

    frx version

Regeln

frx add-redirect

Hinzufügen einer neuen Pfadumleitung für den Virtualisierungstreiber

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

Erforderliche Parameter

-source oder -src

Gibt den Quellpfad an, der umgeleitet werden soll.

-destination oder -dest

Gibt den Pfad an, der als Umleitungsziel fungiert.

Beispiele

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

frx add-rule

Hinzufügen einer bestimmten Regel

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

Beispiele

    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

Erforderliche Parameter

-src-parent

Übergeordnetes Verzeichnis/Schlüssel oder Drucker, für das/den die Regel gilt.

Optionale Parameter

-src

Datei- oder Wertname

-dest-parent

Zielverzeichnis oder -schlüssel (nur Umleitungsregeln)

-dest

Zieldatei oder -wert (nur Umleitungsregeln)

-no-copy

Erstellt beim Umleiten eine leere Kopie des Elements, wenn es nicht vorhanden ist (standardmäßig wird das Quellelement kopiert).

-volatile

Veränderliche Regel, die bei einem Neustart des Computers nicht bestehen bleibt.

-datatype

Typ der zurückzugebenden spezifischen Daten (SZ, DWORD).

-data

Hexadezimale Darstellung der zurückzugebenden Daten.

Spezielle Variablen

Verwendbar in -dest-parent- oder -dest-Parametern.

Variable	Beschreibung
`__USER_SID__`	Benutzer-SID
`__USER_NAME__`	Benutzername
`__USER_PROFILE_PATH__`	Pfad zum Benutzerprofil

frx create-ruleset

Erstellt einen Regelsatz durch Überprüfen des angegebenen Installationsverzeichnisses.

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

Beispiele

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

Parameter

-filename

Gibt den Namen der zu erstellenden Datei an.

-install-dir

Gibt den Installationspfad der zu überprüfenden Anwendung an.

-ARP-keyname

Gibt den Registrierungsspeicherort für „Software“ an.

frx del-redirect

Löscht eine aktive Umleitung.

    frx del-redirect -source <path>

Beispiele

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

Parameter

-source

Gibt den Quellordner an, aus dem die Umleitung entfernt werden soll.

frx del-rule

Löscht die angegebene Regel.

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

Beispiele

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

Erforderliche Parameter

-src-parent

Übergeordnetes Verzeichnis oder Schlüssel, für das/den die Regel gilt.

Optionale Parameter

-src

Datei- oder Wertname.

frx list-redirects

Listet die aktuellen aktiven Ordnerumleitungen auf.

    frx list-redirects

frx list-rules

Listet alle im System geladenen Regeln auf.

    frx list-rules -verbose

Optionale Parameter

-verbose

Zeigt zusätzliche Informationen zur Regel an.

frx reload-rules

Lädt die Regeln neu. Kann für eine Regeldatei spezifisch sein oder für alle Regeln gelten.

Hinweis

Das erneute Laden von Regeln hat keine Auswirkungen auf veränderliche Regeln.

    frx reload-rules -filename <path>

Beispiele

    frx reload-rules -filename Rules.fxr

Optionale Parameter

-filename

Gibt die Regeldatei an, die neu geladen werden soll.

Profile und virtuelle Container

frx copy-profile

Warnung

Wenn die lokale Profilgröße 5 GB überschreitet, müssen Sie den -size-mbs-Parameter mit einer Größe angeben, die größer als 5000 ist.

Kopieren Sie das Benutzerprofil in eine VHD oder VHDX. Wenn die VHD- oder VHDX-Datei nicht vorhanden ist, wird sie erstellt.

    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>

Beispiele

Lokales Profil unter 5 GB

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

Lokales Profil über 5 GB

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

Erforderliche Parameter

-filename

Gibt den Pfad zur VHD(X)-Datei an.

-username

Als Benutzername oder „DOMÄNE\Benutzername“ angegeben.

-sid

Wird anstelle von -username zum Identifizieren des Profils verwendet.

Optionale Parameter

-size-mbs

Größe in Anzahl MBs für neue VHD/VHDX

-vhdx-sector-size

VHDX-Sektorgröße

-dynamic

Für dynamischen Datenträger auf 1 festgelegt, 0 für festen Datenträger

-src-parent

Pfad zur übergeordneten VHDX-Datei für differenzierende Datenträger

-verbose

Aktiviert die ausführliche Ausgabe.

-profile-path

Angeben des Profilpfads

-label

Datenträgervolumebezeichnung (Standard ist Profil)

-redirections

Gibt die Umleitungsdatei an, die in das Profil kopiert werden soll.

frx copyto-vhd

Kopieren eines Ordners und seiner Inhalte in eine VHD oder 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>

Beispiele

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

Erforderliche Parameter

-filename

Gibt den Pfad zur VHDX-Datei an.

-src

Gibt den zu kopierenden Quellordner an.

Optionale Parameter

-dest

Gibt den Zielordner in der VHDX-Datei an. Das Standardziel ist der VHDX-Stammordner.

-size-mbs

Größe in Anzahl MBs für neue VHD/VHDX

-vhdx-sector-size

VHDX-Sektorgröße

-dynamic

Für dynamischen Datenträger auf 1 festgelegt, 0 für festen Datenträger

-verbose

Aktiviert die ausführliche Ausgabe.

-label

Datenträgervolumebezeichnung (Standard ist Profil)

frx create-vhd

Erstellen und formatieren Sie eine VHD oder VHDX. Standardmäßig beträgt die VHD- oder VHDX-Größe 30 GB und wird dynamisch angepasst.

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

Beispiele

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

Erforderliche Parameter

-filename

Gibt den Pfad zur VHDX-Datei an.

Optionale Parameter

-size-mbs

Größe in Anzahl MBs für neue VHD/VHDX

-vhdx-sector-size

VHDX-Sektorgröße

-dynamic

Für dynamischen Datenträger auf 1 festgelegt, 0 für festen Datenträger

-src-parent

Pfad zur übergeordneten VHDX-Datei für differenzierende Datenträger

-label

Datenträgervolumebezeichnung (Standard ist Profil)

frx edit-profile

Fügt die angegebene VHD oder VHDX hinzu an und öffnet ein Explorer-Fenster und einen Registrierungs-Editor, sodass der Inhalt des Profils angezeigt und bearbeitet werden kann.

    frx edit-profile -filename <path>

Beispiele

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

Parameter

-filename

Gibt den Pfad zur VHDX-Datei an.

frx begin-edit-profile

Fügt die angegebene VHD- oder VHDX-Datei an und fügt die Registrierungsstruktur an, damit der Inhalt des Profils angezeigt und bearbeitet werden kann.

    frx begin-edit-profile -filename <path>

Beispiele

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

Parameter

-filename

Gibt den Pfad zur VHDX-Datei an.

frx end-edit-profile

Trennen der angegebenen VHD oder VHDX und der Registrierungsstruktur

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

Beispiele

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

Parameter

-cookie

Gibt das vom begin-edit-profile-Aufruf ausgegebene Cookie an.

-filename

Gibt den Pfad zur VHDX-Datei an.

frx export-profilecfg

Exportiert Profilkonfigurationseinstellungen und Einschluss-/Ausschlussgruppenmitgliedschaften in eine Datei. Die Einstellungen können später mit dem Befehl „import-profilecfg“ importiert werden.

    frx export-profilecfg -filename <path>

Beispiele

    frx export-profilecfg -filename my_configuration.frxconfig

Parameter

-filename

Gibt die Datei für die zu speichernden Konfigurationsdaten an.

frx import-profilecfg

Importiert Profilkonfigurationseinstellungen und Einschluss-/Ausschlussgruppenmitgliedschaften aus einer Datei. Diese Datei kann mit dem Befehl „export-profilecfg“ generiert werden.

    frx import-profilecfg -filename <path>

Beispiele

    frx import-profilecfg -filename my_configuration.frxconfig

Parameter

-filename

Gibt die Datei für die zu speichernden Konfigurationsdaten an.

frx migrate-vhd

Erstellt und formatiert eine VHD oder VHDX und spiegelt den Inhalt der Quell-VHD. Standardmäßig beträgt die VHD- oder VHDX-Größe 30 GB und wird dynamisch angepasst.

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

Beispiele

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

Erforderliche Parameter

-src

Gibt den Pfad zum VHDX-Quelldatenträger an.

-dest

Gibt den neuen VHDX-Dateinamen an.

Optionale Parameter

-size-mbs

Größe in Anzahl MBs für neue VHD/VHDX

-vhdx-sector-size

VHDX-Sektorgröße

-dynamic

Für dynamischen Datenträger auf 1 festgelegt, 0 für festen Datenträger

frx moveto-vhd

Verschiebt einen Ordner mit all seinen Unterordnern und Dateien auf einen VHD(X)-Datenträger.

    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>

Beispiele

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

Erforderliche Parameter

-filename

Gibt den Pfad zur VHDX-Datei an.

-src

Gibt den zu verschiebenden Quellordner an.

Optionale Parameter

-dest

Gibt den Zielordner in der VHDX-Datei an. Das Standardziel ist der VHDX-Stammordner.

-size-mbs

Größe in Anzahl MBs für neue VHD/VHDX

-vhdx-sector-size

VHDX-Sektorgröße

-dynamic

Für dynamischen Datenträger auf 1 festgelegt, 0 für festen Datenträger

-verbose

Aktiviert die ausführliche Ausgabe.

-label

Datenträgervolumebezeichnung (Standard ist Profil)

frx set-profile-redir

Festlegen der Konfiguration der Ordnerumleitungen für Profilordner

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

Beispiele

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

Erforderliche Parameter

-filename

Gibt den Pfad zur VHDX-Datei an.

Optionale Parameter

-redirections

Gibt die Umleitungsdatei an, die in das Profil kopiert werden soll.

-no-redirections

Entfernt vorhandene Umleitungen aus dem Profil.

Suche nach Komponenten

frx reset-user-search-db

Indizieren Sie die Suchindexdatenbank eines Benutzers bzw. einer Benutzerin erneut.

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

Beispiele

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

Parameter

-username

Geben Sie „Benutzername“ oder „Domäne\Benutzername“ an.

-sid

Geben Sie die Benutzer-SID an, anstatt -username zu verwenden.

Schlüsselverwaltung für Anmeldeinformationsverwaltung

frx add-secure-key

Fügen Sie einen sicheren Schlüssel zur Anmeldeinformationsverwaltung hinzu.

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

Beispiele

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

Parameter

-key

Gibt den Schlüsselnamen für die Anmeldeinformationen an.

-value

Gibt den Wert für den gewünschten Schlüssel an.

frx del-secure-key

Löschen eines sicheren Schlüssels aus der Anmeldeinformationsverwaltung

    frx del-secure-key -key <string>

Beispiele

    frx del-secure-key -key fslogix

Parameter

-key

Gibt den Schlüsselnamen für die Anmeldeinformationen an.

frx list-secure-key

Auflisten der in der Anmeldeinformationsverwaltung enthaltenen Schlüssel

    frx list-secure-key

Sonstiges

frx create-junction

Erstellen eines Verknüpfungspunkts zu einem Zielvolume oder -verzeichnis

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

Beispiele

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

Erforderliche Parameter

-src

Gibt das Laufwerk oder den Ordner an, in dem der Verknüpfungspunkt hinzugefügt wird.

-dest

Gibt das Zielverzeichnis oder -volume an.

Optionale Parameter

-name

Optionaler Anzeigename.

frx enable-shnot

Aktivieren von Benachrichtigungen bei Aktualisierungen der Shell

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

Beispiele

    frx enable-shnot -force

Optionale Parameter

-true

Aktiviert Benachrichtigungen.

-false

Deaktiviert Benachrichtigungen.

-force

Erzwingt die sofortige Benachrichtigung, wenn diese aktiviert ist.

frx regfont

Registrieren einer Schriftart in der Systemschriftarttabelle

    frx regfont -filename <path>

Beispiele

    frx regfont -filename C:\myfont.ttf

Parameter

-filename

Gibt den Pfad zur Schriftartdatei an.

frx report-assignment

Berichte über die Anwendbarkeit und Nichtanwendbarkeit eines Regelsatzes durch Analyse der Zuweisungsdatei und von Active Directory.

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

Beispiele

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

Erforderliche Parameter

-filename

Gibt den Pfad zur Zuweisungsdatei an.

Optionale Parameter

-username

Meldet die Anwendbarkeit der Zuweisungsdatei für den/die angegebene(n) Benutzer*in (Distinguished Name).

-verbose

Aktiviert die ausführliche Ausgabe.

-csv

Aktiviert die Ausgabe im CSV-Format (Comma Separated Value).

frx show-junction-info

Zeigt Verknüpfungspunktinformationen für den angegebenen Ordner an.

    frx show-junction-info -src <path>

Beispiele

    frx show-junction-info -src E:\

Parameter

-src

Gibt an, von welchem Laufwerk oder Ordner die Informationen gesammelt werden.

frx unregfont

Entfernen einer Schriftart aus der Systemschriftarttabelle

    frx unregfont -filename <path>

Beispiele

    frx unregfont -filename C:\myfont.ttf

Parameter

-filename

Gibt den Pfad zur Schriftartdatei an.

frx start-agent

Starten aller Treiber und Dienste, die den Agent umfassen

    frx start-agent

frx stop-agent

Beenden alle Treiber und Dienste, die den Agent umfassen

    frx stop-agent

Share via

frx-Befehlszeilenprogramm

Befehle

Regeln

Profile und virtuelle Container

Suche nach Komponenten

Schlüsselverwaltung für Anmeldeinformationsverwaltung

Sonstiges

frx version

Beispiele

Regeln

frx add-redirect

Erforderliche Parameter

Beispiele

frx add-rule

Beispiele

Erforderliche Parameter

Optionale Parameter

Spezielle Variablen

frx create-ruleset

Beispiele

Parameter

frx del-redirect

Beispiele

Parameter

frx del-rule

Beispiele

Erforderliche Parameter

Optionale Parameter

frx list-redirects

frx list-rules

Optionale Parameter

frx reload-rules

Beispiele

Optionale Parameter

Profile und virtuelle Container

frx copy-profile

Beispiele

Erforderliche Parameter

Optionale Parameter

frx copyto-vhd

Beispiele

Erforderliche Parameter

Optionale Parameter

frx create-vhd

Beispiele

Erforderliche Parameter

Optionale Parameter

frx edit-profile

Beispiele

Parameter

frx begin-edit-profile

Beispiele

Parameter

frx end-edit-profile

Beispiele

Parameter

frx export-profilecfg

Beispiele

Parameter

frx import-profilecfg

Beispiele

Parameter

frx migrate-vhd

Beispiele

Erforderliche Parameter

Optionale Parameter

frx moveto-vhd

Beispiele

Erforderliche Parameter

Optionale Parameter

frx set-profile-redir

Beispiele

Erforderliche Parameter

Optionale Parameter

Suche nach Komponenten

frx reset-user-search-db

Beispiele

Parameter

Schlüsselverwaltung für Anmeldeinformationsverwaltung