Profil personnalisé redirections.xml

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.

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 vérifie à 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.

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)

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 de 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 N^th 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

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 conteneur¹.
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>

Étapes suivantes