Tutoriel : créer et implémenter des redirections.xml.

2025-06-27

Dans ce tutoriel, vous allez apprendre à créer et à implémenter redirections.xml.

L’utilisation de fichiers non-Microsoft redirections.xml peut exclure des éléments susceptibles d’affecter le bon fonctionnement du système d’exploitation ou des applications dans votre environnement. Utilisez des instructions d’exclusion et d’inclusion avec parcimonie.

FSLogix redirections.xml fournit une fonctionnalité qui permet d'exclure certaines parties du profil d'un utilisateur de son conteneur. Ce tutoriel vous fournit les étapes de création de votre propre fichier .xml pour exclure les dossiers Microsoft Teams recommandés.

Dans ce tutoriel, vous allez :

Excluez les dossiers Microsoft Teams recommandés pour Virtualized Desktop Infrastructure (VDI).
Vérifiez que le fichier .xml a été copié à partir du dossier source.
Vérifiez que les dossiers ont été exclus.

Prérequis

Créez le fichier redirections.xml

Sélectionnez Démarrer.
Entrez Bloc-notes dans la zone de recherche du menu Démarrer.
Sélectionnez Bloc-notes dans le menu Démarrer .

^{Figure 1 : Bloc-notes dans le menu Démarrer}

Copiez le plan .xml dans le Bloc-notes.

Vous trouverez des informations sur ExcludeCommonFolder dans l'article profil personnalisé redirections.xml.

<?xml version="1.0" encoding="UTF-8"?>
<FrxProfileFolderRedirection ExcludeCommonFolders="0">
<Excludes>
<Exclude Copy="0">AppData\Roaming\Microsoft\Teams\media-stack</Exclude>
<Exclude Copy="0">AppData\Local\Microsoft\Teams\meeting-addin\Cache</Exclude>
<Exclude Copy="0">AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs</Exclude>
<Exclude Copy="0">AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\PerfLogs</Exclude>
<Exclude Copy="0">AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage</Exclude>
</Excludes>
<Includes>
</Includes>
</FrxProfileFolderRedirection>

Sélectionnez Fichier>Enregistrer sous.
Accédez au partage de fichiers où la source de fichier .xml est enregistrée.
Entrez redirections.xml¹ pour le nom du fichier.
Sélectionnez Tous les fichiers (.) pour le type Enregistrer sous .
Cliquez sur Enregistrer.

Note

Les utilisateurs ont besoin d’un accès en lecture au partage de fichiers où le fichier .xml est stocké. Les utilisateurs sans accès en lecture ne peuvent pas copier le fichier .xml pendant la connexion.

Configurez redirections.xml sur la machine virtuelle

Connectez-vous à la machine virtuelle en tant qu’administrateur local ou avec un compte membre du groupe Administrateurs locaux.
Entrez l’éditeur de registre dans la zone de recherche.
Sélectionnez l’Éditeur du Registre dans le menu Démarrer .

^{Figure 2 : Éditeur du Registre dans le menu Démarrer}
Accédez à HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix\Profiles.
Ajoutez ces paramètres :
- Nom de la valeur: RedirXMLSourceFolder
- Type de valeur : REG_SZ
- Valeur : \\<server-name>\<share-name>²
^{Figure 3 : Profils de Registre}

Vérifiez que redirections.xml est copié à l’exclusion des dossiers

Accédez à C :\ProgramData\FSLogix\Logs\Profile.
Ouvrez Profile-%date%.log.
Recherchez la section qui commence par [INFO] ===== Begin Session: StartShell.

Si le fichier redirections.xml a été traité avec succès, le journal d'événements doit être similaire aux journaux d'événements affichés ici :

[23:36:31.364][tid:00000f10.00003bdc][INFO]             Configuration Read (REG_SZ): SOFTWARE\FSLogix\Profiles\RedirXMLSourceFolder.  Data: \\<stg-acct>.file.core.windows.net\containers
[23:36:31.364][tid:00000f10.00003bdc][INFO]             Attempting to copy: "\\<stg-acct>.file.core.windows.net\containers\Redirections.xml" to: "C:\Users\%username%\AppData\Local\FSLogix\Redirections.xml"
[23:36:31.396][tid:00000f10.00003bdc][INFO]             Redirections.xml copy success
[23:36:31.396][tid:00000f10.00003bdc][INFO]             Reading profile folder redirections
[23:36:31.411][tid:00000f10.00003bdc][INFO]             Creating base folders for profile folder redirections
[23:36:31.411][tid:00000f10.00003bdc][INFO]             Creating base folder 'AppData\Roaming\Microsoft\Teams\media-stack\'
[23:36:31.427][tid:00000f10.00003bdc][INFO]             Creating base folder 'AppData\Local\Microsoft\Teams\meeting-addin\Cache\'
[23:36:31.427][tid:00000f10.00003bdc][INFO]             Creating base folder 'AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\'
[23:36:31.427][tid:00000f10.00003bdc][INFO]             Creating base folder 'AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\PerfLogs'
[23:36:31.427][tid:00000f10.00003bdc][INFO]             Creating base folder 'AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage'
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Adding exclude rule for folder 'AppData\Roaming\Microsoft\Teams\media-stack\'
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Added redirection C:\Users\%username%\AppData\Roaming\Microsoft\Teams\media-stack -> C:\Users\local_%username%\AppData\Roaming\Microsoft\Teams\media-stack
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Adding exclude rule for folder 'AppData\Local\Microsoft\Teams\meeting-addin\Cache\'
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Added redirection C:\Users\%username%\AppData\Local\Microsoft\Teams\meeting-addin\Cache -> C:\Users\local_%username%\AppData\Local\Microsoft\Teams\meeting-addin\Cache
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Adding exclude rule for folder 'AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\'
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Added redirection C:\Users\%username%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs -> C:\Users\local_%username%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Adding exclude rule for folder 'AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\PerfLogs\'
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Added redirection C:\Users\%username%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\PerfLogs -> C:\Users\local_%username%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\PerfLogs
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Adding exclude rule for folder 'AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage\'
[23:36:32.099][tid:00000f10.00003bdc][INFO]             Added redirection C:\Users\%username%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage -> C:\Users\local_%username%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage

^{1 Le nom de fichier n’est pas sensible à la casse.}
^{2 N’incluez pas le nom du fichier. Le chemin d’accès peut également être un chemin local si le fichier .xml fait partie d’une image de référence.}

Étape suivante

redirections.xml de profil personnalisé