Perfil personalizado redirections.xml

Importante

Uma alteração futura no Windows, incluída na atualização de abril de 2026 do Windows Server, o tipo de criptografia Kerberos padrão está mudando de RC4 para AES-SHA1.

Compartilhamentos de arquivos que hospedam contêineres FSLogix que não são atualizados para AES-SHA1 podem ter problemas de acesso depois que essa alteração é aplicada. Para evitar interrupções, conclua a atualização para AES-SHA1 antes de instalar a atualização.

Os clientes que já atualizaram para AES-SHA1 não são afetados.

Para obter mais informações, consulte o blog do FSLogix: Ação necessária: a proteção do Windows Kerberos (RC4) pode afetar os perfis FSLogix no armazenamento SMB.

Os redirecionamentos de perfil personalizados são configurados usando um arquivo XML (redirections.xml) localizado no contêiner de perfil do usuário. O FSLogix não cria o arquivo redirections.xml. O arquivo redirections.xml é copiado para o contêiner de perfil do usuário de um local de origem. Na maioria dos casos, o local de origem é um compartilhamento de arquivos remoto em que os usuários têm acesso para copiar de e para o contêiner de perfil. Este documento fornece detalhes sobre o arquivo redirection.xml e a melhor forma de implementá-lo para seu caso de uso específico.

Quando usar redirections.xml

Os dados no perfil do usuário não foram projetados para serem removidos ou excluídos. A menos que você tenha conhecimento íntimo dos dados no perfil ou no aplicativo, não os exclua do contêiner.

Incluir e excluir arquivos e pastas em um contêiner de perfil

Para incluir/excluir arquivos e/ou pastas em um contêiner de perfil de usuário, você precisa criar um arquivo chamado redirections.xml. Esse arquivo define o que copiar ou excluir de/para o contêiner de perfil de um usuário. O arquivo XML é processado durante a entrada e saída de um usuário de uma máquina virtual. Todas as alterações feitas no arquivo XML enquanto o usuário está conectado à máquina virtual não entram em vigor até que ele saia e entre.

Remover ou renomear o arquivo XML no local de origem não o remove ou renomeia para os usuários. Se for necessário remover os redirecionamentos personalizados, limpe o conteúdo do arquivo XML e salve-o no local de origem. No próximo login, o arquivo atualizado será copiado para o contêiner de perfil do usuário.

Observação

redirections.xml só é aplicável quando usado com contêineres de perfil e não tem efeito ao usar contêineres ODFC.

Locais para redirections.xml

O arquivo XML tem dois (2) locais. O local de origem, normalmente um compartilhamento de arquivos remoto, e o local no contêiner de perfil do usuário.

Localização do arquivo de origem

O arquivo XML pode ser localizado centralmente para facilitar a distribuição. A configuração RedirXMLSourceFolder especifica um local onde o cliente verifica, no momento de login, se há um arquivo redirections.xml. Se um for encontrado e for diferente do existente, ele será copiado para o contêiner de perfil do usuário. Em seguida, o conteúdo é processado.

Quando armazenado em um local central (por exemplo, raiz ou subdiretório onde os contêineres de perfil de usuário são armazenados), certifique-se de que os usuários tenham apenas permissões de leitura para o arquivo XML.

Observação

Especifique apenas o caminho para o arquivo redirections.xml, não especifique o nome do arquivo.

Localização do perfil do usuário

O arquivo redirections.xml reside no seguinte local quando copiado do local de origem:

  • %userprofile%\AppData\Local\FSLogix\redirections.xml (dentro do contêiner de perfil do usuário)

Importante

Se alguma entrada ou entradas no redirections.xml forem removidas, o conteúdo ou as pastas permanecerão no VHD(x). Tudo o que for adicionado no redirections.xml é colocado na pasta local_%username% , mas o que já existe no VHD(x) não é removido do VHD(x).

Conteúdo do arquivo XML

O arquivo redirections.xml é composto pela declaração XML, três (3) elementos e dois (2) atributos. A declaração XML é padrão e não deve ser alterada.

Elementos e atributos

  • FrxProfileFolderRedirection: esse é o primeiro elemento no arquivo XML e deve ser usado apenas uma vez.

    • ExcludeCommonFolders: esse atributo define quais pastas conhecidas (se houver) devem ser redirecionadas para fora do contêiner de perfil do usuário. Esse atributo usa um valor de bitmask que informa ao FSLogix qual combinação de pastas excluir. Some os valores de todas as pastas a serem excluídas. Por exemplo, um valor de 7 exclui as pastas Contatos, Área de Trabalho e Documentos.

      • 1: Pasta de contatos
      • 2: Pasta da área de trabalho
      • 4: Pasta de documentos
      • 8: Pasta de Download
      • 16: Pasta de links
      • 32: Pastas de música
      • 64: Pastas de fotos e vídeos
      • 128: Pastas envolvidas em processos de baixo nível de integridade, como AppData\LocalLow

    • Exclusões: Este elemento é utilizado para uma coleção de elementos aninhados Exclude.

      • Excluir: esse elemento descreve um único local a ser excluído do contêiner do usuário. O caminho usado nesses elementos deve existir no caminho do perfil do usuário (%userprofile%). O caminho NÃO deve incluir a C:\Users\%username% parte.
        • Copiar: esse atributo define como o FSLogix lida com os arquivos e pastas durante o redirecionamento. O atributo pode ser omitido do elemento que é o mesmo que usar um valor de 0.
          • 0: Cria uma pasta vazia no local_%username% diretório. Nenhum arquivo é copiado durante a operação. O uso do "Copy 0" é o método mais comum para diminuir o conteúdo do perfil de um usuário. Todos os dados que já estão no contêiner no local não são removidos. Somente dados futuros são criados na local_%username% pasta durante a sessão do usuário e removidos na saída.
          • 1: Cria a pasta no local_%username% diretório E copia os arquivos DO local especificado. Os dados no contêiner são copiados para a local_%username% pasta e todos os novos dados também são gravados nesse caminho. Quando o usuário sai, o local_%username% é removido e qualquer novo dado é perdido. Os dados sempre são copiados do contêiner para o diretório nas local_%username% assinaturas.
          • 2: Cria a pasta no local_%username% diretório E copia os arquivos PARA o local especificado. Uma nova pasta (vazia) é criada em local_%username%. Durante a sessão do usuário, os dados são gravados nesse caminho. Ao fazer logout, os dados são copiados para o contêiner. Não use esse valor, a menos que seja orientado por um engenheiro de suporte da Microsoft.
          • 3: Cria a pasta no local_%username% diretório E copia os arquivos DE e PARA o local especificado. Esse valor combina os efeitos de 1 e 2. Os dados existentes são copiados do contêiner para a local_%username% pasta. Novos dados são gravados no local_%username% caminho e, ao se desconectar, todos os dados são copiados novamente para o contêiner.

    • Includes: Este elemento é usado para uma coleção de elementos aninhados Include.

      • Include: esse elemento é usado para garantir que um subdiretório de um caminho de exclusão seja mantido no contêiner. O valor COPY não é usado nesses elementos. O caminho usado nesses elementos deve existir no caminho do perfil do usuário (%userprofile%). O caminho NÃO deve incluir a C:\Users\%username% parte.

      Observação

      • A pasta ou os dados devem existir no perfil para serem incluídos novamente no contêiner. Por exemplo, novos perfis usando FSLogix com uma instrução include podem não ter todas as estruturas de pastas criadas para um caminho específico porque o usuário nunca usou o aplicativo no contexto de seu contêiner de perfil FSLogix.
      • A pasta pai de um caminho de pasta incluído DEVE existir no contêiner para que a inclusão funcione corretamente.
      • O arquivo XML aceitará qualquer número de Include elementos e Exclude .

Exemplo do arquivo redirections.xml

Importante

Este exemplo mostra como os elementos podem ser usados e não devem ser usados em nenhum ambiente de produção. Siga o tutorial Criar e implementar redirections.xml para uma implementação XML do mundo real. Exclusões e inclusões podem ter consequências inesperadas e devem ser criados com cuidado.

  1. Exclua as pastas conhecidas (Contatos, Links e Música)
  2. Exclua o aplicativo de vendas da Contoso, copiando quaisquer dados do contêiner para a local_%username% pasta e de volta para o contêiner na saída. A instrução de exclusão com cópia move a E/S dos dados para o disco local em vez do contêiner1.
  3. Exclua a pasta Contoso Web App sem nenhuma operação de cópia (todos os dados são removidos na saída).
  4. Inclua de volta a Settings pasta dentro da pasta excluída do Aplicativo Web Contoso.

1 operação de E/S ainda é necessária para copiar os dados.

<?xml version="1.0"  encoding="UTF-8"?>
<FrxProfileFolderRedirection ExcludeCommonFolders="49">
<Excludes>
<Exclude Copy="3">AppData\Roaming\Contoso\ContosoSalesApp</Exclude>
<Exclude Copy="0">AppData\Local\Contoso\ContosoWebApp</Exclude>
</Excludes>
<Includes>
<Include>AppData\Local\Contoso\ContosoWebApp\Settings</Include>
</Includes>
</FrxProfileFolderRedirection>

Observação

  • No Windows 8 e posterior, as pastas envolvidas em processos de baixo nível de integridade são SEMPRE redirecionadas para o local_%username% diretório.
  • Se a mesma pasta for especificada em ambos os Exclude elementos e Include , o Exclude terá precedência.
  • Para listar os redirecionamentos implementados pelo FSLogix, use o utilitário de linha de comando frx.

Próximas etapas

redirections.xml Perguntas frequentes

  • Last updated on