Freigeben über

Benutzerdefiniertes Profil redirections.xml

  • Artikel

Benutzerdefinierte Profilumleitungen werden mithilfe einer XML-Datei (redirections.xml) konfiguriert, die sich im Profilcontainer des Benutzers befindet. FSLogix erstellt die Datei redirections.xml nicht. Die Datei redirections.xml wird aus einem Quellspeicherort in den Profilcontainer des Benutzers kopiert. In den meisten Fällen ist der Quellspeicherort eine Remotedateifreigabe, auf die die Benutzer Zugriff haben, um von und in ihren Profilcontainer zu kopieren. Dieses Dokument enthält Details zur Datei redirection.xml und wie sie am besten für Ihren spezifischen Anwendungsfall implementiert werden kann.

Wann sollte redirections.xml verwendet werden?

Die Daten im Benutzerprofil sind nicht dafür gedacht, entfernt oder ausgeschlossen zu werden. Wenn Sie die Daten im Profil oder in der Anwendung nicht genau kennen, sollten Sie sie nicht aus dem Container ausschließen.

Einschließen und Ausschließen von Dateien und Ordnern in einem Profilcontainer

Um Dateien und/oder Ordner in den Profilcontainer eines Benutzers aufzunehmen oder daraus auszuschließen, müssen Sie eine redirections.xml-Datei erstellen. Diese Datei definiert, was in den Profilcontainer eines Benutzers kopiert oder daraus ausgeschlossen werden soll. Die XML-Datei wird bei der An- und Abmeldung eines Benutzers an einer virtuellen Maschine verarbeitet. Alle Änderungen, die an der XML-Datei vorgenommen werden, während der Benutzer an der virtuellen Maschine angemeldet ist, werden erst wirksam, wenn er sich ab- und anmeldet.

Das Entfernen oder Umbenennen der XML-Datei am Quellspeicherort bewirkt nicht, dass sie für die Benutzer entfernt oder umbenannt wird. Wenn Sie die benutzerdefinierten Umleitungen entfernen müssen, löschen Sie den Inhalt der XML-Datei und speichern Sie sie am Quellspeicherort. Bei der nächsten Anmeldung wird die aktualisierte Datei in den Profilcontainer des Benutzers kopiert.

Hinweis

edirections.xml ist nur mit Profilcontainern anwendbar und hat keine Auswirkungen auf ODFC-Container.

Speicherorte für redirections.xml

Die XML-Datei hat zwei (2) Speicherorte. Der Quellspeicherort, in der Regel eine Remotedateifreigabe, und der Speicherort im Profilcontainer des Benutzers.

Quelldateispeicherort

Zur einfachen Verteilung kann die XML-Datei an einem zentralen Ort gespeichert werden. Die Einstellung RedirXMLSourceFolder gibt einen Speicherort an, an dem der Client bei der Anmeldung überprüft, ob eine redirections.xml-Datei vorhanden ist. Wenn eine gefunden wird und sich von der vorhandenen unterscheidet, wird sie in den Profilcontainer des Benutzers kopiert. Anschließend werden die Inhalte verarbeitet.

Wenn die Datei an einem zentralen Ort gespeichert ist (z. B. im Stammverzeichnis oder in einem Unterverzeichnis, in dem die Benutzerprofil-Container gespeichert sind), sollten die Benutzer nur Leserechte für die XML-Datei haben.

Hinweis

Geben Sie nur den Pfad zur Datei redirections.xml an, geben Sie nicht den Dateinamen an.

Speicherort des Benutzerprofils

Die Datei redirections.xml befindet sich am folgenden Speicherort, wenn sie vom Quellspeicherort kopiert wird:

  • %userprofile%\AppData\Local\FSLogix\redirections.xml (innerhalb des Profilcontainers des Benutzers)

Wichtig

Wenn ein oder mehrere Einträge aus der Datei redirections.xml entfernt werden, verbleiben die Inhalte oder Ordner in der VHD(x). Alles, was in der Datei redirections.xml hinzugefügt wird, wird in den Ordner local_%username% gelegt, aber was bereits in der VHD(x) vorhanden ist, wird nicht aus der VHD(x) entfernt.

XML-Dateiinhalte

Die Datei redirections.xml besteht aus der XML-Deklaration, drei (3) Elementen und zwei (2) Attributen. Die XML-Deklaration ist Standard und sollte nicht geändert werden.

Elemente und Attribute

  • FrxProfileFolderRedirection: Dies ist das erste Element in der XML-Datei und sollte nur einmal verwendet werden.

    • ExcludeCommonFolders: Dieses Attribut definiert, welche bekannten Ordner (falls vorhanden) aus dem Profilcontainer des Benutzers umgeleitet werden sollen. Es nimmt einen Bitmaskenwert an, der FSLogix mitteilt, welche Kombination von Ordnern ausgeschlossen werden soll. Addieren Sie die Werte für alle auszuschließenden Ordner. Beispielsweise schließt ein Wert von 7 die Ordner „Kontakte“, „Desktop“ und „Dokumente“ aus.

      • 1: Ordner Kontakte
      • 2: Ordner Desktop
      • 4: Ordner Dokumente
      • 8: Ordner Downloads
      • 16: Ordner Links
      • 32: Ordner Musik
      • 64: Ordner Bilder und Videos
      • 128: Ordner, die an Prozessen mit niedriger Integritätsstufe beteiligt sind, wie AppData\LocalLow

    • Ausgeschlossen: Dieses Element wird für eine Sammlung von verschachtelten Exclude -Elementen verwendet.

      • Ausgeschlossen: Dieses Element beschreibt einen einzelnen Speicherort, der vom Container des Benutzers ausgeschlossen werden soll. Der in diesen Elementen verwendete Pfad muss im Profilpfad des Benutzers (%userprofile%) vorhanden sein. Der Pfad darf NICHT den Teil C:\Users\%username% des Pfads enthalten.
        • Copy: Dieses Attribut definiert, wie FSLogix die Dateien und Ordner während der Umleitung verarbeitet. Das Attribut kann im Element weggelassen werden, was einem Wert von 0 gleichkommt.
          • 0: Erstellt einen leeren Ordner im Verzeichnis local_%username%. Während des Vorgangs werden keine Dateien kopiert. Copy 0 ist der am häufigsten verwendete Wert, um den Inhalt eines Benutzerprofils zu verringern. Daten, die sich bereits im Container an diesem Speicherort befinden, werden nicht entfernt. Während der Sitzung des Benutzers werden nur künftige Daten im Ordner local_%username% erstellt und bei der Abmeldung entfernt.
          • 1: Erstellt den Ordner im Verzeichnis local_%username% UND kopiert die Dateien VOM angegebenen Speicherort. Daten im Container werden in den Ordner local_%username% kopiert. Alle neuen Daten werden ebenfalls in diesen Pfad geschrieben. Beim Abmelden des Benutzers wird die Option local_%username% entfernt, und alle neuen Daten gehen verloren. Bei der n-ten Anmeldung werden immer Daten aus dem Container in den Ordner local_%username% kopiert.
          • 2: Erstellt den Ordner im local_%username% Verzeichnis UND kopiert die Dateien an den angegebenen Speicherort. Ein neuer (leerer) Ordner wird erstellt in local_%username%. Während der Sitzung des Benutzers werden Daten in diesen Pfad geschrieben. Bei der Abmeldung werden die Daten in den Container kopiert. Verwenden Sie diesen Wert nur auf Anweisung eines Microsoft-Supporttechnikers.
          • 3: Erstellt den Ordner im Verzeichnislocal_%username% UND kopiert die Dateien VON und IN den angegebenen Speicherort. Dieser Wert kombiniert die Auswirkungen von 1 und 2. Vorhandene Daten werden aus dem Container und in den Ordner local_%username% kopiert. Neue Daten werden in den Pfad local_%username% geschrieben und bei der Abmeldung werden alle Daten wieder in den Container kopiert.

    • Eingeschlossen: Dieses Element wird für eine Sammlung verschachtelter Include-Elemente verwendet.

      • Eingeschlossen: Dieses Element wird verwendet, um sicherzustellen, dass ein Unterverzeichnis eines Exclude-Pfads im Container verbleibt. Der COPY-Wert wird in diesen Elementen nicht verwendet. Der in diesen Elementen verwendete Pfad muss im Profilpfad des Benutzers (%userprofile%) vorhanden sein. Der Pfad darf NICHT den Teil C:\Users\%username% des Pfads enthalten.

      Hinweis

      • Der Ordner oder die Daten müssen im Profil vorhanden sein, um wieder in den Container aufgenommen zu werden. Bei neuen Profilen, die FSLogix mit einer Include-Anweisung verwenden, werden beispielsweise möglicherweise nicht alle Ordnerstrukturen für einen bestimmten Pfad erstellt, weil der Benutzer die Anwendung nie im Kontext seines FSLogix-Profilcontainers verwendet hat.
      • Der übergeordnete Ordner eines eingeschlossenen Ordnerpfads MUSS im Container vorhanden sein, damit das Einschließen ordnungsgemäß funktioniert.
      • Die XML-Datei akzeptiert eine beliebige Anzahl von Include- und Exclude-Elementen.

Beispiel für redirections.xml

Wichtig

In diesem Beispiel wird gezeigt, wie die Elemente verwendet werden können. Befolgen Sie das Lernprogramm Erstellen und Implementieren von redirections.xm für eine reale XML-Implementierung. Ausschlüsse und Einschlüsse können unerwartete Folgen haben und müssen mit Sorgfalt erstellt werden.

  1. Schließen Sie die bekannten Ordner (Kontakte, Links und Musik) aus.
  2. Schließen Sie die Contoso-Vertriebs-App aus, indem Sie alle Daten aus dem Container in den Ordner local_%username% und beim Abmelden zurück in den Container kopieren. Die Exclude-Anweisung mit Copy verschiebt die E/A der Daten auf den lokalen Datenträger und nicht in den Container1.
  3. Schließen Sie den Microsoft Edge-Ordner ohne Kopiervorgang aus (alle Daten werden beim Abmelden entfernt).
  4. Schließen Sie den Ordner innerhalb des ausgeschlossenen Microsoft Edge-Ordners wieder User Data ein.

1 Zum Kopieren der Daten ist weiterhin E/A erforderlich.

<?xml version="1.0"  encoding="UTF-8"?>
<FrxProfileFolderRedirection ExcludeCommonFolders="49">
<Excludes>
<Exclude Copy="3">AppData\Roaming\Contoso\ContosoSalesApp</Exclude>
<Exclude Copy="0">AppData\Local\Microsoft\Edge</Exclude>
</Excludes>
<Includes>
<Include>AppData\Local\Microsoft\Edge\User Data</Include>
</Includes>
</FrxProfileFolderRedirection>

Hinweis

  • Unter Windows 8 und höher werden Ordner, die an Prozessen auf niedriger Integritätsebene beteiligt sind, IMMER in das Verzeichnis local_%username% umgeleitet.
  • Wenn derselbe Ordner in beiden Elementen Exclude und Include angegeben ist, hat Exclude Vorrang.
  • Um die von FSLogix bereitgestellten Umleitungen aufzuführen, verwenden Sie das Befehlszeilenprogramm frx.

Nächste Schritte

redirections.xml