Perfil personalizado redirections.xml

Para incluir/excluir ficheiros e/ou pastas dentro de um contentor de perfil de utilizador, precisa de criar um ficheiro chamado redirections.xml. Este ficheiro define o que copiar ou excluir para/a partir do contentor de perfil do utilizador. O ficheiro XML é processado durante o início e saída de sessão de um utilizador numa máquina virtual. Quaisquer alterações feitas ao ficheiro XML enquanto o utilizador está ligado à máquina virtual não entram em vigor até que este saia e volte a iniciar sessão.

Remover ou renomear o ficheiro XML na localização de origem não o remove nem renomeia para os utilizadores. Se for necessário remover os redirecionamentos personalizados, limpe o conteúdo do ficheiro XML e guarde-o na localização de origem. No próximo login, o ficheiro atualizado será copiado para o contentor de perfil do utilizador.

Localizações para redirections.xml

O ficheiro XML tem duas (2) localizações. A localização de origem, normalmente uma partilha remota de ficheiros, e a localização no contentor de perfil do utilizador.

Localização do Ficheiro de Origem

O ficheiro XML pode ser localizado centralmente para facilitar a distribuição. A definição RedirXMLSourceFolder especifica um local onde o cliente verifica no início de sessão se há um ficheiro redirections.xml. Se for encontrado um e for diferente do existente, é copiado para o contentor de perfil do utilizador. Depois, o conteúdo é processado.

Quando armazenado numa localização central (por exemplo, raiz ou subdiretório onde os contentores de perfil de utilizador estão armazenados), certifique-se de que os utilizadores só têm permissões de leitura para o ficheiro XML.

Localização do Perfil do Utilizador

O ficheiro redirections.xml reside na seguinte localização quando copiado da localização de origem:

• %userprofile%\AppData\Local\FSLogix\redirections.xml (dentro do contentor de perfil do utilizador)

Conteúdo do ficheiro XML

O ficheiro 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: Este é o primeiro elemento do ficheiro XML e deve ser usado apenas uma vez.

  • ExcludeCommonFolders: Este atributo define quais (se houver) pastas bem conhecidas devem ser redirecionadas para fora do contentor de perfil do utilizador. Este atributo recebe um valor de máscara de bits que indica ao FSLogix qual a combinação de pastas a excluir. Soma os valores de todas as pastas a excluir. Por exemplo, um valor de 7 exclui as pastas Contactos, Ambiente de Trabalho e Documentos.

    • 1: Pasta de contactos
    • 2: Pasta do ambiente de trabalho
    • 4: Pasta de documentos
    • 8: Pasta de downloads
    • 16: Pasta de Links
    • 32: Pastas de música
    • 64: Pastas de Imagens e Vídeos
    • 128: Pastas envolvidas em processos de Baixo Nível de Integridade como AppData\LocalLow

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

    • Excluir: Este elemento descreve um único local a excluir do contentor do utilizador. O caminho usado nestes elementos deve existir no caminho do perfil do utilizador (%userprofile%). O caminho NÃO deve incluir a parte C:\Users\%username% do caminho.
      • Cópia: Este atributo define como o FSLogix gere os ficheiros 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 ficheiro é copiado durante a operação. Copy 0 é o valor mais comum usado para reduzir o conteúdo do perfil de um utilizador. Quaisquer dados que já estejam no contentor nesse local não são removidos. Apenas os dados da sessão são criados na pasta local_%username% durante a sessão do utilizador e removidos ao terminar a sessão.
        • 1: Cria a pasta no local_%username% diretório E copia os ficheiros DO local especificado. Os dados no contentor são copiados para a local_%username% pasta e quaisquer novos dados também são escritos nesse caminho. Ao encerrar sessão, o elemento local_%username% é removido e quaisquer novos dados serão perdidos. O N^th login copia sempre os dados do contentor para a local_%username% pasta.
        • 2: Cria a pasta no local_%username% diretório E copia os ficheiros PARA a localização especificada. Uma nova pasta (vazia) é criada em local_%username%. Durante a sessão do utilizador, os dados são escritos nesse caminho. Ao sair, os dados são copiados para o contentor. Não use este 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 ficheiros DE e PARA a localização especificada. Este valor combina os efeitos de 1 e 2. Os dados existentes são copiados do contentor e colocados na local_%username% pasta. Novos dados são escritos para o caminho local_%username% e, quando terminar a sessão, todos os dados são copiados de volta para o container.

  • Inclui: Este elemento é utilizado para reunir uma coleção de Include elementos aninhados.

    • Incluir: Este elemento é usado para garantir que um subdiretório de um caminho de exclusão é mantido no contentor. O valor COPY não é usado nestes elementos. O caminho usado nestes elementos deve existir no caminho do perfil do utilizador (%userprofile%). O percurso NÃO deve incluir a C:\Users\%username% parte do percurso.

    Observação

    • A pasta ou os dados devem existir no perfil para serem incluídos novamente no contentor. Por exemplo, novos perfis que usam FSLogix com uma instrução include podem não ter todas as estruturas de pastas criadas para um caminho específico porque o utilizador nunca utilizou a aplicação no contexto do seu contentor de perfil FSLogix.
    • A pasta mãe de um caminho de pasta incluída DEVE estar presente no contentor para que a inclusão funcione corretamente.
    • O ficheiro XML aceita qualquer número de elementos Include e elementos Exclude.

redirections.xml de exemplo

1. Exclua as pastas mais conhecidas (Contactos, Links e Música)
2. Exclua a App Contoso Sales, copiando quaisquer dados do contentor para a local_%username% pasta e de volta para o contentor ao terminar a sessão. A instrução de exclusão com cópia move a entrada/saída dos dados para o disco local em vez do contentor¹.
3. Exclua a pasta Microsoft Edge sem operação de cópia (todos os dados são removidos ao sair do logout).
4. Inclua novamente a User Data pasta dentro da pasta Microsoft Edge excluída.

^{Ainda é necessário 1 I/O 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óximos passos