Referência de parâmetro de configuração

  • Artigo

Este artigo descreve as várias configurações do Registro aplicáveis ao FSLogix que incluem, mas não se limitam a:

  • Serviços de Aplicativos
  • Contêineres de perfil
  • Contêineres ODFC
  • Cache na nuvem
  • Logging

Configurações padrão

Depois de instalar o FSLogix, o instalador criará um conjunto base de chaves e valores do Registro que fornece a estrutura para adicionar definições de configuração. O FSLogix não cria NENHUM nome de valor de definição de configuração como parte da instalação. Qualquer definição de configuração listada nesta página que tenha um 'Valor padrão' não precisa ser criada ou configurada, pois o FSLogix usará automaticamente o valor padrão conforme listado.

Por exemplo, a RoamIdentity configuração tem um valor padrão como '0'. O FSLogix não fará roaming de identidades como um comportamento padrão e não precisará de um Administrador para criar ou adicionar o nome e o valor do valor do Registro. Somente se o desejo for alterar o comportamento padrão da configuração, o administrador criará ou adicionará o nome e o valor do valor do Registro.

Chaves de registro base e nomes de valor

  • [HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix]
    • \Apps
      • "InstallPath"="C:\Program Files\FSLogix\Apps\"
      • "InstallVersion"="version_number"
    • \Logging
    • \Profiles
    • \SystemInfo
    • \Telemetry
    • \UserModeDll
  • [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\FSLogix]
    • \ODFC

Variáveis de ambiente personalizadas

Algumas configurações do FSLogix aceitarão variáveis de ambiente. Essas configurações aceitarão a lista de variáveis de ambiente personalizadas e quaisquer variáveis disponíveis durante a entrada do usuário.

Variáveis personalizadas do FSLogix:

Variável Descrição
%username% SAMAcountName para o usuário conectado.
%userdomain% Nome de domínio NETBIOS onde a conta do usuário reside.
%sid% Identificador de segurança
%osmajor% Versão principal dos sistemas operacionais como visto em: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentMajorVersionNumber
%osminor% Versão secundária dos sistemas operacionais como visto em: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentMinorVersionNumber
%osbuild% Versão de compilação dos sistemas operacionais como visto em: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber
%osservicepack% Legado para service packs do Windows, não mais usados.
%profileversion% Versão do perfil baseado na versão do Windows.
%clientname% O COMPUTERNAME do cliente que inicia a conexão com o host.

Configurações dos Serviços de Aplicativo

As configurações a seguir são aplicáveis ao FSLogix e não específicas a contêineres de perfil ou ODFC ou Cloud Cache.

CleanupInvalidSessions

Colmeia do Registro: HKEY_LOCAL_MACHINE

Caminho do Registro: SOFTWARE\FSLogix\Apps

Nome do valor: CleanupInvalidSessions

Tipo de valor: DWORD

Valor habilitado: 1

Valor desabilitado: 0 (padrão)

Nos casos em que a sessão de um usuário termina abruptamente, o VHD(x) montado para o perfil do usuário não é desanexado corretamente e o próximo login do usuário pode não anexar com êxito seu contêiner VHD(x). Habilite essa configuração e o FSLogix tenta limpar essas sessões inválidas e permitir uma entrada bem-sucedida. Essa configuração afeta os contêineres Profile e ODFC.

RoamLixeira

Colmeia do Registro: HKEY_LOCAL_MACHINE

Caminho do Registro: SOFTWARE\FSLogix\Apps

Nome do valor: RoamRecycleBin

Tipo de valor: DWORD

Valor habilitado: 1 (padrão)

Valor desativado: 0

Quando habilitada, essa configuração cria um redirecionamento para a Lixeira específica do usuário para o contêiner VHD(x). Isso permite que o usuário restaure itens independentemente da máquina de onde eles foram excluídos.

VHDCompactDisk

Colmeia do Registro: HKEY_LOCAL_MACHINE

Caminho do Registro: SOFTWARE\FSLogix\Apps

Nome do valor: VHDCompactDisk

Tipo de valor: DWORD

Valor habilitado: 1 (padrão)

Valor desativado: 0

Quando habilitada, essa configuração tenta compactar o disco VHD durante a operação de logout e é projetada para diminuir automaticamente o Size On Disk contêiner do usuário, dependendo de um limite predefinido. Para obter mais informações, consulte a documentação de compactação de disco VHD.

Configurações do FSLogix (Perfil, ODFC, Cache na Nuvem, Log)

Configurações do contêiner de perfil

As configurações a seguir são aplicáveis a contêineres de perfil e são criadas no seguinte local:

  • Colmeia do Registro: HKEY_LOCAL_MACHINE
  • Caminho do Registro: SOFTWARE\FSLogix\Profiles

AccessNetworkAsComputerObject

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: padrão – anexar como usuário.
  • 1: Anexar como computador - A pasta deve ter permissões para objetos de computador.

Cuidado

Não use essa definição de configuração, a menos que seu provedor de armazenamento ou arquitetura NÃO funcione com permissões em nível de usuário para os locais de contêiner VHD(x). Essa configuração permitirá que a máquina virtual acesse todos os arquivos VHD(x) no provedor de armazenamento, criando um risco potencial de segurança.

AttachVHDSDDL

Tipo: REG_SZ

Valor padrão: N/D

Valores de dados e uso:

SDDL string que representa as ACLs a serem usadas ao conectar o VHD(x).

CleanOutNotifications

Tipo: DWORD

Valor padrão: 1

Valores de dados e uso:

  • 0: Nenhuma ação.
  • 1: Limpa entradas de notificação obsoletas.

Essa configuração limpa entradas obsoletas criadas pela Plataforma de Notificação por Push do Windows (WPN) e pelo Recurso de Notificação do Windows (WFN) que, sob algumas condições, levam a entradas lentas.

DeleteLocalProfileWhenVHDShouldApply

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Nenhuma ação.
  • 1: Exclui o perfil local se existir e corresponde ao contêiner de perfil.

Importante

Quando o FSLogix determina que um usuário deve ter um contêiner de perfil FSLogix e existe um perfil local, o FSLogix exclui permanentemente o perfil local.

DiffDiskParentFolderPath

Tipo: REG_SZ

Valor padrão: %TEMP%

Valores de dados e uso:

Especifica o caminho onde os discos de diferença são criados quando ProfileType é configurado para usá-los. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon.

Enabled

(configuração obrigatória)

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Contêineres de perfil desativados.
  • 1: Contêineres de perfil habilitados.

FlipFlopProfileDirectoryName

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: A pasta SID é criada como %sid%_%username%
  • 1: A pasta SID é criada como %username%_%sid%

Importante

Certifique-se de entender como as configurações conflitantes são aplicadas e priorizadas.

  • Essa configuração substituirá SIDDirNameMatche SIDDirNamePattern
  • Essa configuração NÃO tem efeito quando NoProfileContainingFolder está habilitado
  • NoProfileContainingFolder>FlipFlopProfileDirectoryName> (SIDDirNameMatch e SIDDirNamePattern)

IgnorarNãoWVD

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: FSLogix está habilitado para qualquer sessão.
  • 1: O FSLogix está habilitado apenas para sessões da Área de Trabalho Virtual (AVD) do Azure.

Observação

A Área de Trabalho Virtual do Windows (WVD) agora é conhecida como Área de Trabalho Virtual do Azure (AVD), embora o nome da configuração use o nome herdado.

InstallAppxPackages

Tipo: DWORD

Valor padrão: 1

Valores de dados e uso:

Quando habilitada (1), essa configuração lê o arquivo de manifesto AppxPackages.xml do perfil do usuário e instala/registra novamente a lista de aplicativos. O arquivo AppxPackages.xml pode ser encontrado em: %LocalAppData%\FSLogix\AppxPackages.xml. Essa configuração controla o comportamento global no Windows para todos os aplicativos AppX. Isso só melhora a funcionalidade quando usado com o FSLogix.

Aviso

O arquivo AppxPackages.xml não deve ser editado ou modificado. Editar esse arquivo pode causar resultados inesperados e o arquivo é substituído a cada saída.

IsDynamic

Tipo: DWORD

Valor padrão: 1

Valores de dados e uso:

  • 0: VHD(x) é de um tamanho fixo e o tamanho no disco é totalmente alocado.
  • 1: VHD(x) é dinâmico e só aumenta o tamanho no disco conforme necessário.

Observação

  • Essa configuração é usada com a configuração SizeInMBs para gerenciar o tamanho dos contêineres de perfil. Definir IsDynamic como 1 faz com que o contêiner Profile use o espaço mínimo no disco, independentemente dos SizeInMBs alocados. À medida que o espaço é consumido, o tamanho no disco aumenta até o tamanho especificado em SizeInMBs. SizeInMBs é o tamanho máximo que um usuário tem permissão para usar no disco. Se o contêiner de perfil do usuário crescer além do especificado em SizeInMBs , o usuário enfrentará erros.
  • Definir IsDynamic como 1 NÃO permite que o contêiner Profile cresça mais do que o especificado em SizeInMBs.

KeepLocalDir

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: O é excluído durante a local_%username% saída.
  • 1: A local_%username% pasta será deixada no sistema, após sair. Ele também será usado novamente se o mesmo usuário fizer logon.

LockedRetryCount

Tipo: DWORD

Valor padrão: 12

Valores de dados e uso:

Especifica o número de tentativas de repetição quando um arquivo VHD(x) é bloqueado (aberto por outro processo ou computador).

LockedRetryInterval

Tipo: DWORD

Valor padrão: 5

Valores de dados e uso:

Especifica o número de segundos a aguardar entre novas tentativas (consulte LockedRetryCount).

NoProfileContainingFolder

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Desativado.
  • 1: O contêiner de perfil não usa nem cria uma pasta contendo SID para o arquivo VHD(x).

Essa configuração destina-se a situações em que o armazenamento fornece um local que já é exclusivo por usuário.

Importante

Certifique-se de entender como as configurações conflitantes são aplicadas e priorizadas.

  • Essa configuração substituirá QUALQUER OUTRA configuração relacionada a pastas de contêiner.
    • SIDDIRNameMatch não tem efeito quando usado em conjunto com essa configuração.
    • SIDDIRNamePattern não tem efeito quando usado em conjunto com essa configuração.
    • FlipFlopProfileDirectoryName não tem efeito quando usado em conjunto com essa configuração.

OutlookCachedMode

Tipo: DWORD

Valor padrão: 1

Valores de dados e uso:

  • 0: Impede que o FSLogix faça qualquer coisa com o modo em cache.
  • 1: Somente quando o contêiner Perfil é anexado, a configuração do Outlook que habilita o modo em cache é definida temporariamente até que o contêiner seja desanexado. Essa configuração garante que o modo armazenado em cache seja usado somente quando o contêiner estiver conectado.

Importante

  • O Outlook deve ser configurado para o modo online para que esse recurso funcione. Isso garante que, se o FSLogix for desativado, arquivos OST grandes não serão baixados.
  • Entrada de registro no modo online: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\office\16.0\Outlook\OST\NoOST:DWORD = 2.
  • O FSLogix substituirá essa configuração para o usuário atual.

PreventLoginWithFailure

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

Quando ativado (1), o FSLogix carrega o FRXShell se houver uma falha ao se conectar ou usar um VHD(x) de perfil existente. O usuário recebe o prompt padrão para chamar o suporte e a única opção dos usuários é sair.

PreventLoginWithTempProfile

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

Quando ativado (1), o FSLogix carrega o FRXShell se for determinado que um perfil temporário foi criado. O usuário recebe o prompt padrão para chamar o suporte e a única opção dos usuários é sair.

ProfileDirSDDL

Tipo: REG_SZ

Valor padrão: N/D

Valores de dados e uso:

Cadeia de caracteres SDDL que representa as ACLs a serem usadas ao criar o diretório de perfil.

Tipo de perfil

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Comportamento normal do perfil.
  • 1: A máquina deve ser apenas a instância do perfil RW.
  • 2: A máquina deve ser apenas a instância do perfil de RO.
  • 3: A máquina deve tentar assumir a função RW e, se não puder, deve voltar para uma função RO.

Importante

  • Todas as sessões que tentam usar o VHD simultaneamente devem ter uma configuração ProfileType correspondente. Se o VHD não for acessado simultaneamente, ProfileType deverá ser 0.
  • O OneDrive não oferece suporte a várias conexões simultâneas/várias conexões simultâneas, usando o mesmo perfil, em nenhuma circunstância. Para obter mais informações, consulte Usar o aplicativo de sincronização em áreas de trabalho virtuais.

ReAttachRetryCount

Tipo: DWORD

Valor padrão: 60

Valores de dados e uso:

Especifica o número de vezes que o sistema deve tentar reconectar o contêiner VHD(x) se ele for desconectado inesperadamente.

ReAttachIntervalSeconds

Tipo: DWORD

Valor padrão: 10

Valores de dados e uso:

Especifica o número de segundos a aguardar entre novas tentativas ao tentar reconectar o contêiner VHD(x) se ele for desconectado inesperadamente.

RebootOnUserLogoff

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Desativado.
  • 1: Reinicialize quando qualquer usuário sair.
  • 2: Reinicialize quando um usuário de perfil FSLogix sair.

Tipo de redirecionamento

Tipo: DWORD

Valor padrão: 2

Valores de dados e uso:

  • 1: Use o redirecionamento herdado.
  • 2: Use o redirecionamento avançado FSLogix.

RedirXMLSourceFolder

Tipo: REG_SZ

Valor padrão: N/D

Valores de dados e uso:

Caminho onde o FSLogix procura o arquivo redirections.xml para copiar de e para o perfil do usuário. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon. Por exemplo, C:\Windows\System32 ou \\<server-name>\<share-name>

Observação

Não adicione o nome do arquivo ao caminho. Essa configuração é apenas um caminho de pasta.

RemoveOrphanedOSTFilesOnLogoff

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Desativado.
  • 1: Arquivos OST duplicados são excluídos durante a saída.

Observação

Em casos raros, arquivos OST duplicados são criados para um usuário. Essa circunstância tem sido documentada para ocorrer com e sem o uso de um perfil não persistente. Quando o perfil é armazenado no sistema de arquivos padrão, os administradores podem remover arquivos OST órfãos ou obsoletos excluindo-os. Ao usar o FSLogix, o arquivo OST está no contêiner e não é tão visível. Durante longos períodos de tempo, arquivos OST duplicados podem consumir espaço em disco incremental. Quando ativado (1) FSLogix excluirá todos os arquivos OST em um VHD(x), exceto o OST com a data de modificação mais recente. Os administradores devem estar familiarizados com o uso de arquivos OST e possíveis implicações antes de optar por habilitar essa configuração.

RoamIdentidade

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Não faça roaming de credenciais e tokens dentro do contêiner.
  • 1: Habilita o roaming herdado para credenciais e tokens criados pelo sistema WAM (Web Account Manager).

Em alguns cenários de identidade e autenticação, os usuários podem ser obrigados a se autenticar em seus aplicativos do Microsoft 365 a cada entrada. Habilitar essa configuração é uma maneira de resolver o problema. Recomendamos trabalhar para o verdadeiro logon único, que permite que o logon do Windows passe sua credencial para seus aplicativos do Microsoft 365.

Importante

  • A configuração padrão é não fazer roaming das credenciais ou tokens , que é a configuração preferida. Embora essa possa não ser a configuração ideal para alguns clientes, criamos essa configuração para fornecer aos clientes uma maneira de fazer roaming desses itens de forma semelhante ao FSLogix v2201 hotfix 2 (2.9.8228.50276).
  • NÃO habilite essa configuração se você usar o Microsoft Intune para gerenciar seus dispositivos.

RoamSearch

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Desativado.
  • 1: Habilite a pesquisa de usuário único.
  • 2: Habilite a pesquisa multiusuário.

Para obter mais informações, consulte Configurar roaming de banco de dados do Windows Search.

Importante

  • A funcionalidade de roaming de pesquisa FSLogix não é mais necessária em versões mais recentes do Windows1
  • O RoamSearch é definido antes dos GPOs serem aplicados, não é possível confiar nos GPOs para definir o RoamSearch em ambientes onde um GoldImage é aplicado na inicialização.

1 Windows Server 2019 versão 1809 e posterior, Windows 10 e 11 multi-sessão

SetTempToLocalPath

Tipo: DWORD

Valor padrão: 3

Valores de dados e uso:

  • 0: Desativado.
  • 1: Redirecionar TEMP e TMP para a unidade local.
  • 2: Redirecionar INetCache para a unidade local.
  • 3: Redirecionar TEMP, TMP e INetCache para a unidade local.

ShutdownOnUserLogoff

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Desativado.
  • 1: Desligamento quando qualquer usuário sair.
  • 2: Desligamento quando um usuário FSLogix sair.

SIDDirNameMatch

Tipo: REG_SZ

Valor padrão: %sid%_%username%

Valores de dados e uso:

Especifica um padrão de cadeia de caracteres usado ao corresponder a um perfil ou pasta de contêiner ODFC. Use essa configuração para definir como o FSLogix tenta localizar um perfil de usuário ou contêiner ODFC. O FSLogix usa o VHDLocations ou CCDLocations como o local onde pesquisar e essa configuração define o que pesquisar. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon.

Importante

Certifique-se de entender como as configurações conflitantes são aplicadas e priorizadas.

  • Ao usar essa definição de configuração, verifique se o valor SIDDIRNamePattern corresponde a essa configuração.
    • Essa configuração NÃO tem efeito quando FlipFlopProfileDirectoryName está habilitado.
    • Essa configuração NÃO tem efeito quando NoProfileContainingFolder está habilitado.
    • NoProfileContainingFolder FlipFlopProfileDirectoryName>SIDDirNameMatch (esta configuração)>

SIDDirNamePattern

Tipo: REG_SZ

Valor padrão: %sid%_%username%

Valores de dados e uso:

Especifica um padrão de cadeia de caracteres usado ao criar um perfil ou uma pasta de contêiner ODFC. Use essa configuração para definir como o FSLogix tenta criar um perfil de usuário ou uma pasta de contêiner ODFC. O FSLogix usa o VHDLocations ou CCDLocations como o local onde criar e essa configuração define o que criar. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon.

Importante

Certifique-se de entender como as configurações conflitantes são aplicadas e priorizadas.

  • Ao usar essa definição de configuração, verifique se o valor SIDDIRNameMatch corresponde a essa configuração.
    • Essa configuração NÃO tem efeito quando FlipFlopProfileDirectoryName está habilitado.
    • Essa configuração NÃO tem efeito quando NoProfileContainingFolder está habilitado.
    • NoProfileContainingFolder FlipFlopProfileDirectoryName>SIDDirNamePattern (esta configuração)>

SIDDirSDDL

Tipo: REG_SZ

Valor padrão: N/D

Valores de dados e uso:

SDDL string que representa as ACLs a serem usadas ao criar a pasta de contêiner SID.

SizeInMBs

Tipo: DWORD

Valor padrão: 30000

Valores de dados e uso:

Especifica o tamanho máximo do contêiner do usuário em megabytes. Os contêineres VHD(x) recém-criados são desse tamanho. Os contêineres existentes são estendidos automaticamente para esse tamanho durante a entrada do usuário. Você pode aumentar esse valor a qualquer momento, mas não pode diminuí-lo. Diminuir esse valor não faz com que os contêineres VHD(x) existentes diminuam.

VHDNameMatch

Tipo: REG_SZ

Valor padrão: Profile*

Valores de dados e uso:

Especifica um padrão de cadeia de caracteres usado ao corresponder a um contêiner de perfil de usuários. Use essa configuração para definir como o FSLogix tenta localizar um contêiner de perfil de usuário (arquivo VHD(x). O FSLogix usa o VHDLocations ou CCDLocations como o local onde pesquisar e essa configuração define o que pesquisar. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon.

Importante

Ao usar essa definição de configuração, verifique se o valor VHDNamePattern corresponde a essa configuração.

VHDNamePattern

Tipo: REG_SZ

Valor padrão: Profile_%username%

Valores de dados e uso:

Especifica um padrão de cadeia de caracteres usado ao criar um contêiner de perfil de usuários. Use essa configuração para definir como o FSLogix tenta criar um contêiner de perfil de usuário (arquivo VHD(x). O FSLogix usa VHDLocations ou CCDLocations como o local onde pesquisar e essa configuração define o que criar. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon.

Importante

Ao usar essa definição de configuração, verifique se o valor VHDNameMatch corresponde a essa configuração.

VHDLocations

(configuração obrigatória)

Tipo: MULTI_SZ ou REG_SZ

Valor padrão: N/D

Valores de dados e uso:

Uma lista de locais SMB para procurar o arquivo VHD(x) de perfil do usuário. Se um não for encontrado, ele será criado na primeira localização listada. Se o caminho VHD não existir, ele será criado antes de verificar se um VHD(x) existe no caminho. O caminho oferece suporte ao uso das variáveis personalizadas do FSLogix ou de quaisquer variáveis de ambiente disponíveis para o usuário durante o processo de logon. Quando especificado como um valor REG_SZ, vários locais devem ser separados com ponto-e-vírgula (;).

VHDXSectorSize

Tipo: DWORD

Valor padrão: 0

Valores de dados e uso:

  • 0: Usa o padrão do sistema.
  • 512: VHD(x) é formatado usando alocação de 512 bytes.
  • 4096: VHD(x) é formatado usando alocação de 4096 bytes.

Observação

Os valores são listados em decimal e não em hexagonal.

VolumeType

Tipo: REG_SZ

Valor padrão: vhd

Valores de dados e uso:

Um valor de vhd significa que os arquivos recém-criados devem ser do tipo VHD. Um valor de vhdx significa que os arquivos recém-criados devem ser do tipo VHDX.

VolumeWaitTimeMS

Tipo: DWORD

Valor padrão: 20000

Valores de dados e uso:

Especifica o número de milissegundos que o sistema deve aguardar até que o volume chegue após o VHD(x) ter sido conectado. Valor padrão de 20000 = 20 segundos