Perfil personalizado redirections.xml

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.

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.

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)

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

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êiner¹.
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>

Próximas etapas