Profil personnalisé redirections.xml

  • Article

Les redirections de profil personnalisées sont configurées à l’aide d’un fichier XML (redirections.xml) situé dans le conteneur de profil de l’utilisateur. FSLogix ne crée pas le fichier redirections.xml. Le fichier redirections.xml est copié dans le conteneur de profil de l’utilisateur à partir d’un emplacement source. Dans la plupart des cas, l’emplacement source est un partage de fichiers distant où les utilisateurs ont accès à copier depuis et dans leur conteneur de profil. Ce document fournit des détails sur le fichier redirection.xml et la meilleure façon de l’implémenter pour votre cas d’usage spécifique.

Quand utiliser redirections.xml

Les données du profil de l’utilisateur ne sont pas conçues pour être supprimées ou exclues. Sauf si vous avez une connaissance intime des données dans le profil ou l’application, ne l’excluez pas du conteneur.

Inclure et exclure des fichiers et des dossiers dans un conteneur de profils

Pour inclure / exclure des fichiers et / ou dossiers au sein d’un conteneur de profil utilisateur, vous devez créer un fichier appelé redirections.xml. Ce fichier définit ce qu’il faut copier ou exclure vers/à partir du conteneur de profil d’un utilisateur. Le fichier XML est traité pendant la connexion d’un utilisateur et se déconnecte d’une machine virtuelle. Les modifications apportées au fichier XML pendant la connexion de l’utilisateur à la machine virtuelle ne prennent effet qu’à la déconnexion et à la connexion.

La suppression ou le changement de nom du fichier XML à l’emplacement source ne le supprime pas ni ne le renomme pour les utilisateurs. S’il est nécessaire de supprimer les redirections personnalisées, effacez le contenu du fichier XML et enregistrez-le à l’emplacement source. Lors de la prochaine connexion, le fichier mis à jour est copié dans le conteneur de profil de l’utilisateur.

Remarque

redirections.xml s’applique uniquement lorsqu’il est utilisé avec des conteneurs de profil et n’a aucun effet lors de l’utilisation de conteneurs ODFC.

Emplacements pour redirections.xml

Le fichier XML a deux (2) emplacements. Emplacement source, généralement un partage de fichiers distant et l’emplacement dans le conteneur de profil de l’utilisateur.

Emplacement du fichier source

Le fichier XML peut être localisé de manière centralisée pour faciliter la distribution. Le paramètre RedirXMLSourceFolder spécifie un emplacement où le client case activée s lors de la connexion pour voir s’il existe un fichier redirections.xml. Si l’un est trouvé et qu’il est différent de celui existant, il est copié dans le conteneur de profil de l’utilisateur. Ensuite, le contenu est traité.

Lorsqu’ils sont stockés dans un emplacement central (par exemple, racine ou sous-répertoire où les conteneurs de profil utilisateur sont stockés), assurez-vous que les utilisateurs disposent uniquement d’autorisations de lecture dans le fichier XML.

Remarque

Spécifiez uniquement le chemin d’accès au fichier redirections.xml, ne spécifiez pas le nom du fichier.

Emplacement du profil de l’utilisateur

Le fichier redirections.xml réside à l’emplacement suivant lors de la copie à partir de l’emplacement source :

  • %userprofile%\AppData\Local\FSLogix\redirections.xml (à l’intérieur du conteneur de profil de l’utilisateur)

Important

Si une entrée ou une entrée dans la redirections.xml sont supprimées, le contenu ou les dossiers restent dans le disque dur virtuel(x). Tout ce qui est ajouté dans le redirections.xml est placé dans le dossier local_%username% , mais ce qui existe déjà dans le disque dur virtuel (x) n’est pas supprimé du disque dur virtuel (x).

Contenu du fichier XML

Le fichier redirections.xml est composé de la déclaration XML, de trois (3) éléments et de deux (2) attributs. La déclaration XML est standard et ne doit pas être modifiée.

Éléments et attributs

  • FrxProfileFolderRedirection : il s’agit du premier élément du fichier XML et ne doit être utilisé qu’une seule fois.

    • ExcludeCommonFolders : cet attribut définit les dossiers connus (le cas échéant) qui doivent être redirigés hors du conteneur de profil de l’utilisateur. Cet attribut prend une valeur de masque de bits qui indique à FSLogix quelle combinaison de dossiers exclure. Ajoutez les valeurs de tous les dossiers à exclure. Par exemple, la valeur 7 exclut les dossiers Contacts, Bureau et Documents.

      • 1 : Dossier Contacts
      • 2 : Dossier de bureau
      • 4 : Dossier documents
      • 8 : Télécharger le dossier
      • 16 : Dossier liens
      • 32 : dossiers Musique
      • 64 : Dossiers images et vidéos
      • 128 : Dossiers impliqués dans des processus de bas niveau d’intégrité comme AppData\LocalLow

    • Exclut : cet élément est utilisé pour une collection d’éléments imbriqués Exclude .

      • Exclure : cet élément décrit un emplacement unique à exclure du conteneur de l’utilisateur. Le chemin utilisé dans ces éléments doit exister dans le chemin de profil de l’utilisateur (%userprofile%). Le chemin d’accès ne doit pas inclure la C:\Users\%username% partie du chemin.
        • Copie : cet attribut définit la façon dont FSLogix gère les fichiers et dossiers pendant la redirection. L’attribut peut être omis de l’élément identique à l’utilisation d’une valeur de 0.
          • 0 : Crée un dossier vide dans le local_%username% répertoire. Aucun fichier n’est copié pendant l’opération. La copie 0 est la valeur la plus courante utilisée pour diminuer le contenu du profil d’un utilisateur. Toutes les données qui se trouvent déjà dans le conteneur à l’emplacement ne sont pas supprimées. Seules les données futures sont créées dans le local_%username% dossier pendant la session de l’utilisateur et supprimées lors de la déconnexion.
          • 1 : Crée le dossier dans le local_%username% répertoire ET copie les fichiers FROM à l’emplacement spécifié. Les données du conteneur sont copiées dans le local_%username% dossier et toutes les nouvelles données sont également écrites dans ce chemin. Lorsque l’utilisateur se déconnecte, il local_%username% est supprimé et toutes les nouvelles données sont perdues. Les connexions Nth copient toujours les données du conteneur vers le local_%username% dossier.
          • 2 : Crée le dossier dans le local_%username% répertoire ET copie les fichiers à l’emplacement spécifié. Un nouveau dossier (vide) est créé dans local_%username%. Pendant la session de l’utilisateur, les données sont écrites dans ce chemin. Lors de la déconnexion, les données sont copiées dans le conteneur. N’utilisez pas cette valeur, sauf s’il est dirigé par un ingénieur du support Technique Microsoft.
          • 3 : Crée le dossier dans le local_%username% répertoire ET copie les fichiers FROM et TO à l’emplacement spécifié. Cette valeur combine les effets de 1 et 2. Les données existantes sont copiées hors du conteneur et dans le local_%username% dossier. De nouvelles données sont écrites dans le chemin d’accès et lors de la local_%username% déconnexion, toutes les données sont copiées dans le conteneur.

    • Inclut : cet élément est utilisé pour une collection d’éléments imbriqués Include .

      • Include : cet élément est utilisé pour garantir qu’un sous-répertoire d’un chemin d’accès d’exclusion est conservé dans le conteneur. La valeur COPY n’est pas utilisée dans ces éléments. Le chemin utilisé dans ces éléments doit exister dans le chemin de profil de l’utilisateur (%userprofile%). Le chemin d’accès ne doit pas inclure la C:\Users\%username% partie du chemin.

      Remarque

      • Le dossier ou les données doivent exister dans le profil pour être inclus dans le conteneur. Par exemple, de nouveaux profils utilisant FSLogix avec une instruction Include peuvent ne pas avoir toutes les structures de dossiers créées pour un chemin spécifique, car l’utilisateur n’a jamais utilisé l’application dans le contexte de son conteneur de profil FSLogix.
      • Le dossier parent d’un chemin d’accès de dossier inclus DOIT exister dans le conteneur pour que l’inclusion fonctionne correctement.
      • Le fichier XML accepte n’importe quel nombre d’élémentsInclude.Exclude

Exemple de redirections.xml

Important

Cet exemple montre comment les éléments peuvent être utilisés. Suivez le didacticiel Créer et implémenter redirections.xml pour une implémentation XML réelle. Les exclues et les inclut peuvent avoir des conséquences inattendues et doivent être créées avec soin.

  1. Exclure les dossiers connus (Contacts, Liens et Musique)
  2. Excluez l’application Contoso Sales App, en copiant toutes les données du conteneur vers le local_%username% dossier et de nouveau dans le conteneur lors de la déconnexion. L’instruction exclude avec copie déplace les E/S des données vers le disque local au lieu du conteneur1.
  3. Excluez le dossier Microsoft Edge sans opération de copie (toutes les données sont supprimées lors de la déconnexion).
  4. Incluez le User Data dossier dans le dossier Microsoft Edge exclu.

1 E/S est toujours nécessaire pour copier les données.

<?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>

Remarque

  • Sur Windows 8 et versions ultérieures, les dossiers impliqués dans les processus de bas niveau d’intégrité sont TOUJOURS redirigés vers le local_%username% répertoire.
  • Si le même dossier est spécifié dans les deux Exclude et Include les éléments, il Exclude est prioritaire.
  • Pour répertorier les redirections mises en place par FSLogix, utilisez l’utilitaire de ligne de commande frx.

Étapes suivantes

FAQ redirections.xml