Compartilhar via

Perfil personalizado redirections.xml

  • Artigo

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. Na próxima entrada, 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 em que o cliente faz check-in na entrada para ver 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 downloads
      • 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

    • Exclui: esse elemento é usado 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 do caminho.
        • 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. A cópia 0 é o valor mais comum usado 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. Ao sair do usuário, o local_%username% é removido e todos os novos dados são perdidos. Os enésimos logins sempre copiam os dados do contêiner para a local_%username% pasta.
          • 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 sair, 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 sair, todos os dados são copiados de volta para o contêiner.

    • Includes: esse 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 do caminho.

      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 redirections.xml

Importante

Este exemplo mostra como os elementos podem ser usados. Siga o tutorial Criar e implementar redirections.xml para uma implementação XML do mundo real. Excluir e incluir 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 todos os dados do contêiner para a local_%username% pasta e de volta para o contêiner na saída. A instrução exclude com copy move a E/S dos dados para o disco local em vez do contêiner1.
  3. Exclua a pasta do Microsoft Edge sem nenhuma operação de cópia (todos os dados são removidos na saída).
  4. Inclua de volta a User Data pasta dentro da pasta excluída do Microsoft Edge.

1 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\Microsoft\Edge</Exclude>
</Excludes>
<Includes>
<Include>AppData\Local\Microsoft\Edge\User Data</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