As extensões de preferência dão suporte para variáveis de ambiente do Windows e geram algumas variáveis de ambiente de processamento adicionais. Qualquer variável pode ser usada em um valor de parâmetro de configuração. Cada documento da Ajuda define se as variáveis são aceitas em um campo específico.

Observação

Com o uso de itens de direcionamento Direcionamento de correspondência de registro, você pode definir variáveis em tempo de execução do cliente e ter o comportamento de controle usando os itens de direcionamento de Direcionamento de variável de ambiente ou como valores em uma configuração de item de preferência.

Variáveis de ambiente do Windows

O ambiente do Windows é uma lista de variáveis salvas como pares de nome/valor. Para ver a lista atual de variáveis, digite SET no prompt de comando. Cada processo, incluindo a área de trabalho, tem uma lista de variáveis exclusivas. Quando um processo inicia outro, normalmente uma cópia do ambiente do processo iniciador é passada para o processo iniciado. Geralmente, os nomes de variável de ambiente são colocados entre símbolos de porcentagem (por exemplo, %ProgramFiles%). O Windows resolve a variável de ambiente quando um aplicativo solicita o valor associado ao nome.

Variáveis de processo de preferência

As extensões de preferência implementam as variáveis de processo listadas aqui.

Observação

As variáveis não diferenciam maiúsculas de minúsculas.

%AppDataDir%

O diretório de dados do aplicativo do usuário atual.

%BinaryComputerSid%

O SID do computador em formato hexadecimal.

%BinaryUserSid%

O SID do usuário atual em formato hexadecimal.

%CommonAppdataDir%

O diretório de dados do aplicativo de "todos os usuários".

%CommonDesktopDir%

O diretório de área de trabalho de "todos os usuários".

%CommonFavoritesDir%

O diretório de favoritos do Explorer de "todos os usuários".

%CommonProgramsDir%

O diretório de programas de "todos os usuários".

%CommonStartMenuDir%

O diretório do menu iniciar de "todos os usuários".

%CommonStartUpDir%

O diretório de inicialização de "todos os usuários".

%ComputerName%

O nome NetBIOS do computador.

%CurrentProcessId%

A identificação numérica do principal processo do cliente.

%CurrentThreadId%

A identificação numérica do principal thread do cliente.

%DateTime%

A hora atual (UTC).

%DateTimeEx%

A hora atual (UTC) com milissegundos.

%DesktopDir%

O diretório de área de trabalho do usuário atual.

%DomainName%

O nome de domínio ou grupo de trabalho do computador.

%FavoritesDir%

O diretório de favoritos do Explorer do usuário atual.

%LastError%

O último código de erro encontrado durante a configuração.

%LastErrorText%

O texto de descrição do último código de erro.

%LdapComputerSid%

O SID do computador em formato binário precedido de LDAP.

%LdapUserSid%

O SID do usuário atual em formato binário precedido de LDAP.

%LocalTime%

A hora local atual.

%LocalTimeEx%

A hora local atual com milissegundos.

%LogonDomain%

O domínio do usuário atual.

%LogonServer%

O controlador de domínio que autenticou o usuário atual.

%LogonUser%

O nome do usuário atual.

%LogonUserSid%

O SID do usuário atual.

%MacAddress%

O primeiro endereço MAC detectado no computador.

%NetPlacesDir%

O diretório Meus Locais de Rede do usuário atual.

%OsVersion%

O sistema operacional: Windows Server® 2008 R2, Windows® 7, Windows Server® 2008, Windows Vista®, Windows Server 2003, Windows XP ou Desconhecido.

%ProgramFilesDir%

O diretório de arquivos de programa do Windows.

%ProgramsDir%

O diretório de programas do usuário atual.

%RecentDocumentsDir%

O diretório de documentos recentes do usuário atual.

%ResultCode%

O código de saída do cliente.

%ResultText%

O texto de descrição do código de saída do cliente.

%ReversedComputerSid%

O SID do computador em formato hexadecimal na ordem de byte inversa.

%ReversedUserSid%

O SID do usuário atual em formato hexadecimal na ordem de byte inversa.

%SendToDir%

O diretório Enviar para do usuário atual.

%StartMenuDir%

O diretório do menu iniciar do usuário atual.

%StartUpDir%

O diretório de inicialização do usuário atual.

%SystemDir%

O diretório do sistema do Windows.

%SystemDrive%

O nome da unidade da qual o sistema operacional está sendo executado.

%TempDir%

O diretório temporário do usuário atual, como determinado pela API do Windows.

%TimeStamp%

O carimbo de data/hora das configurações que estão sendo implementadas.

%TraceFile%

O caminho/nome do arquivo de rastreamento.

%WindowsDir%

O diretório do Windows.

As extensões de preferência fornecem uma lista de variáveis que você pode escolher para inserir nas caixas de texto. Você pode abrir a caixa de diálogo de qualquer caixa de texto que:

  • não esteja desabilitada;

  • Não é somente leitura.

  • não esteja restrita a um valor numérico.

Para inserir uma variável

  1. Abra o Console de Gerenciamento de Diretiva de Grupo. Clique com o botão direito do mouse no objeto de Diretiva de Grupo (GPO) que contém o item de preferência a ser configurado e clique em Editar.

  2. Coloque o cursor sobre a caixa desejada.

    • Para inserir uma variável de processo de preferência, pressione F3, selecione uma variável na lista e clique em Selecionar para inseri-la na caixa.

    • Para inserir uma variável de ambiente do Windows existente, digite-a na caixa.

      Observação

      Você pode evitar a resolução de uma variável antes que ela seja aplicada aos computadores clientes (para que a variável, em vez de o valor resolvido, apareça na configuração da preferência nos computadores clientes). Para isso, desmarque a caixa de seleção Resolver Variável. Isso inserirá <> entre os delimitadores % % e o nome da variável (por exemplo, %<ProgramFiles>%). As extensões de preferência removem os caracteres < > do texto e deixam a variável não resolvida. Você também pode usar essa sintaxe com uma variável de ambiente do Windows.

Referências adicionais

Sumário