Compartir a través de

Redirections.xml de perfil personalizado

  • Artículo

Las redirecciones de perfil personalizadas se configuran mediante un archivo XML (redirections.xml) ubicado dentro del contenedor de perfiles del usuario. FSLogix no crea el archivo redirections.xml. El archivo redirections.xml se copia en el contenedor de perfiles del usuario desde una ubicación de origen. En la mayoría de los casos, la ubicación de origen es un recurso compartido de archivos remoto donde los usuarios tienen acceso para copiar desde y en su contenedor de perfiles. En este documento se proporcionan detalles sobre el archivo redirection.xml y cómo implementarlo mejor para su caso de uso específico.

Cuándo usar redirections.xml

Los datos del perfil del usuario no están diseñados para quitarse ni excluirse. A menos que tenga conocimiento íntimo de los datos en el perfil o la aplicación, no lo excluya del contenedor.

Incluir y excluir archivos y carpetas dentro de un contenedor de perfiles

Para incluir o excluir archivos o carpetas dentro de un contenedor de perfiles de usuarios, debe crear un archivo denominado redirections.xml. Este archivo define qué copiar o excluir en / del contenedor de perfiles de un usuario. El archivo XML se procesa durante el inicio de sesión de los usuarios y se cierra la sesión de una máquina virtual. Los cambios realizados en el archivo XML mientras el usuario ha iniciado sesión en la máquina virtual, no surten efecto hasta que cierren la sesión e inicien sesión.

Quitar o cambiar el nombre del archivo XML en la ubicación de origen no lo quita ni cambia de nombre para los usuarios. Si es necesario quitar las redirecciones personalizadas, borre el contenido del archivo XML y guárdelo en la ubicación de origen. En el siguiente inicio de sesión, el archivo actualizado se copiará en el contenedor de perfiles del usuario.

Nota:

redirections.xml solo es aplicable cuando se usa con contenedores de perfiles y no tiene ningún efecto al usar contenedores de ODFC.

Ubicaciones de redirections.xml

El archivo XML tiene dos (2) ubicaciones. La ubicación de origen, normalmente un recurso compartido de archivos remoto y la ubicación en el contenedor de perfiles del usuario.

Ubicación del archivo de origen

El archivo XML se puede ubicar centralmente para facilitar la distribución. La configuración RedirXMLSourceFolder especifica una ubicación en la que el cliente comprueba el inicio de sesión para ver si hay un archivo redirections.xml. Si se encuentra una y es diferente de la existente, se copia en el contenedor de perfiles del usuario. A continuación, se procesan los contenidos.

Cuando se almacena en una ubicación central (por ejemplo, raíz o subdirectorio donde se almacenan los contenedores de perfiles de usuario), asegúrese de que los usuarios solo tienen permisos de lectura para el archivo XML.

Nota:

Especifique solo la ruta de acceso al archivo redirections.xml, no especifique el nombre de archivo.

Ubicación del perfil del usuario

El archivo redirections.xml reside en la siguiente ubicación cuando se copia desde la ubicación de origen:

  • %userprofile%\AppData\Local\FSLogix\redirections.xml (dentro del contenedor de perfiles del usuario)

Importante

Si se quita cualquier entrada o entrada de la redirections.xml, el contenido o las carpetas permanecen en el VHD(x). Todo lo que se agregue en el redirections.xml se coloca en la carpeta local_%username% , pero lo que ya existe en el VHD(x) no se quita del VHD(x).

Contenido del archivo XML

El archivo redirections.xml se compone de la declaración XML, tres (3) elementos y dos atributos (2). La declaración XML es estándar y no debe cambiarse.

Atributos y elementos

  • FrxProfileFolderRedirection: este es el primer elemento del archivo XML y solo se debe usar una vez.

    • ExcludeCommonFolders: este atributo define qué carpetas conocidas (si existen) se deben redirigir fuera del contenedor de perfiles del usuario. Este atributo toma un valor de máscara de bits que indica a FSLogix qué combinación de carpetas se van a excluir. Agregue los valores de todas las carpetas que se van a excluir. Por ejemplo, un valor de 7 excluye las carpetas Contactos, Escritorio y Documentos.

      • 1: Carpeta contactos
      • 2: Carpeta de escritorio
      • 4: Carpeta documentos
      • 8: Carpeta de descargas
      • 16: Carpeta vínculos
      • 32: carpetas de Música
      • 64: Carpetas imágenes y vídeos
      • 128: Carpetas implicadas en procesos de bajo nivel de integridad, como AppData\LocalLow

    • Excluye: este elemento se usa para una colección de elementos anidadosExclude.

      • Exclude: este elemento describe una sola ubicación para excluir del contenedor del usuario. La ruta de acceso usada en estos elementos debe existir en la ruta de acceso del perfil del usuario (%userprofile%). La ruta de acceso NO debe incluir la C:\Users\%username% parte de la ruta de acceso.
        • Copy: este atributo define cómo FSLogix controla los archivos y carpetas durante el redireccionamiento. El atributo se puede omitir del elemento que es el mismo que el uso de un valor de 0.
          • 0: Crea una carpeta vacía en el local_%username% directorio. No se copia ningún archivo durante la operación. Copy 0 es el valor más común que se usa para reducir el contenido del perfil de un usuario. No se quitan los datos que ya están en el contenedor en la ubicación. Solo se crean datos futuros en la carpeta durante la local_%username% sesión del usuario y se quitan al cerrar sesión.
          • 1: Crea la carpeta en el local_%username% directorio AND copia los archivos FROM la ubicación especificada. Los datos del contenedor se copian en la local_%username% carpeta y los datos nuevos también se escriben en esa ruta de acceso. Al cerrar la sesión del local_%username% usuario, se quita y se pierden los datos nuevos. Nº inicios de sesión siempre copia los datos del contenedor en la local_%username% carpeta.
          • 2: Crea la carpeta en el local_%username% directorio AND copia los archivos en la ubicación especificada. Se crea una nueva carpeta (vacía) en local_%username%. Durante la sesión del usuario, los datos se escriben en esa ruta de acceso. Al cerrar sesión, los datos se copian en el contenedor. No use este valor a menos que lo dirija un ingeniero de soporte técnico de Microsoft.
          • 3: Crea la carpeta en el local_%username% directorio AND copia los archivos FROM y TO la ubicación especificada. Este valor combina los efectos de 1 y 2. Los datos existentes se copian del contenedor y en la local_%username% carpeta . Los nuevos datos se escriben en la local_%username% ruta de acceso y, al cerrar la sesión, todos los datos se copian de nuevo en el contenedor.

    • Incluye: este elemento se usa para una colección de elementos anidados Include .

      • Include: este elemento se usa para asegurarse de que un subdirectorio de una ruta de acceso de exclusión se mantiene en el contenedor. El valor COPY no se usa en estos elementos. La ruta de acceso usada en estos elementos debe existir en la ruta de acceso del perfil del usuario (%userprofile%). La ruta de acceso NO debe incluir la C:\Users\%username% parte de la ruta de acceso.

      Nota:

      • La carpeta o los datos deben existir en el perfil para volver a incluirse en el contenedor. Por ejemplo, es posible que los nuevos perfiles que usan FSLogix con una instrucción include no tengan todas las estructuras de carpeta creadas para una ruta de acceso específica porque el usuario nunca ha usado la aplicación en el contexto de su contenedor de perfiles de FSLogix.
      • La carpeta primaria de una ruta de acceso de carpeta incluida DEBE existir en el contenedor para que la inclusión funcione correctamente.
      • El archivo XML aceptará cualquier número de Include elementos y Exclude .

Ejemplo de redirections.xml

Importante

En este ejemplo se muestra cómo se pueden usar los elementos. Siga el tutorial Creación e implementación de redirections.xml para una implementación XML real. Las inclusión e inclusión pueden tener consecuencias inesperadas y deben crearse con cuidado.

  1. Excluir las carpetas conocidas (contactos, vínculos y Música)
  2. Excluya la aplicación Contoso Sales, copie los datos del contenedor en la local_%username% carpeta y vuelva al contenedor al cerrar la sesión. La instrucción exclude con copy mueve la E/S de los datos al disco local en lugar del contenedor1.
  3. Excluya la carpeta Microsoft Edge sin ninguna operación de copia (todos los datos se quitan al cerrar sesión).
  4. Incluya de nuevo la User Data carpeta dentro de la carpeta de Microsoft Edge excluida.

1 E/S sigue siendo necesaria para copiar los datos.

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

Nota:

  • En Windows 8 y versiones posteriores, las carpetas implicadas en procesos de bajo nivel de integridad siempre se redirigen al local_%username% directorio.
  • Si se especifica la misma carpeta en los Exclude elementos y Include , tendrá Exclude prioridad.
  • Para enumerar las redirecciones puestas en marcha por FSLogix, use la utilidad de línea de comandos frx.

Pasos siguientes

Preguntas más frecuentes sobre redirections.xml