FSLogix Profile Containers Redirections¶
A list of folder redirections for use with FSLogix Profile Containers and a method for generating the list in the expected XML format. See Controlling the Content of the Profile Container for more details.
The list of redirections (
Redirections.csv) is hosted here in CSV format so that it can be rendered in a table when viewed on GitHub and to simplify adding to or updating the list.
Test Before Implementing in Production¶
Redirections.csv is not a definitive list of paths to exclude or include in the Profile Container. You should assess each of the paths included in this list for your environment and understand whether a path should be excluded or cleaned up with alternative methods. It is likely that additional paths can be added to the list. With community feedback, this list can be improved.
It is also important to understand the performance impacts of implementing exclusions for Profile Containers. Ensure that the
redirections.xml that you implement in your environment is well tested before moving into production.
Install the Script¶
There are two methods for installing the script:
- Install from the PowerShell Gallery. This is the preferred method as the installation can be handled directly from Windows PowerShell or PowerShell Core with the following command:
Install-Script -Name ConvertTo-RedirectionsXml
- Download from the repository.
ConvertTo-RedirectionsXml.ps1can be downloaded directly from this repository and saved to a preferred location.
ConvertTo-RedirectionsXml is used to convert the CSV list into the correct XML format for use with Profile Containers. This script will read the
Redirections.csv from GitHub repo and output
Redirections.xml locally for use with Profile Containers.
Redirections.xml to the current folder, just run the script without arguments.
A custom path can be provided for the output file - for example, the following command will output the file to
ConvertTo-RedirectionsXml -OutFile C:\Temp\Redirections.xml
If you have saved the script locally instead of installing from the PowerShell Gallery, remember to run the script with the correct syntax:
How To Contribute¶
Contributions to the list of folders to exclude or include from the Profile Container is needed to improve the list. There are two ways to contribute:
- Fork the repo, update
redirections.csvand create a Pull Request
- If would prefer not to create a pull request, you can instead create a new issue to request an addition or improvement