As extensões de preferência suportam variáveis do ambiente Windows e geram várias variáveis de ambiente de processos adicionais. Qualquer variável pode ser utilizada num valor de parâmetro de configuração. Cada documento de Ajuda indica se as variáveis são suportadas num campo específico.

Nota

Ao utilizar itens de direccionamento Filtragem de Correspondência do Registo, pode definir variáveis em tempo de execução de cliente e dispor deste comportamento de controlo utilizando os itens de direccionamento Filtragem de Variável de Ambiente ou como valores numa definição de item de preferência.

Variáveis de ambiente do Windows

O ambiente do Windows é uma lista de variáveis guardadas como pares nome/valor. Para ver a lista actual de variáveis, escreva SET na linha de comandos. Cada processo, incluindo o ambiente de trabalho, tem uma lista de variáveis exclusiva para o processo. Quando um processo inicia outro, normalmente é transmitida uma cópia do ambiente do processo de inicialização ao processo iniciado. Normalmente, os nomes das variáveis de ambiente estão entre dois sinais de percentagem (por exemplo, %ProgramFiles%). O Windows resolve a variável de ambiente quando uma aplicação solicita o valor associado ao nome.

Variáveis de processos de preferência

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

Nota

As variáveis não são sensíveis às maiúsculas e minúsculas.

%AppDataDir%

O directório Dados da Aplicação do utilizador actual.

%BinaryComputerSid%

O SID do computador em formato hexadecimal.

%BinaryUserSid%

O SID do utilizador actual em formato hexadecimal.

%CommonAppdataDir%

O directório Dados da Aplicação de "all users".

%CommonDesktopDir%

O directório Ambiente de Trabalho de "all users".

%CommonFavoritesDir%

O directório Favoritos do Explorador de "all users".

%CommonProgramsDir%

O directório Programas de "all users".

%CommonStartMenuDir%

O directório Menu Iniciar de "all users".

%CommonStartUpDir%

O directório Arranque de "all users".

%ComputerName%

O nome NetBIOS do computador.

%CurrentProcessId%

A identidade numérica do processo de cliente principal.

%CurrentThreadId%

A identidade numérica do thread de cliente principal.

%DateTime%

A hora actual (UTC).

%DateTimeEx%

A hora actual (UTC) com milissegundos.

%DesktopDir%

O directório de ambiente de trabalho do utilizador actual.

%DomainName%

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

%FavoritesDir%

O directório Favoritos do Explorador do utilizador actual.

%LastError%

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

%LastErrorText%

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

%LdapComputerSid%

O SID do computador em formato binário LDAP.

%LdapUserSid%

O SID do utilizador actual em formato binário LDAP.

%LocalTime%

A hora local actual.

%LocalTimeEx%

A hora local actual com milissegundos.

%LogonDomain%

O domínio do utilizador actual.

%LogonServer%

O controlador de domínio que autenticou o utilizador actual.

%LogonUser%

O nome do utilizador actual.

%LogonUserSid%

O SID do utilizador actual.

%MacAddress%

O primeiro endereço MAC detectado no computador.

%NetPlacesDir%

O directório Os Meus Locais na Rede do utilizador actual.

%OsVersion%

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

%ProgramFilesDir%

O directório Programas do Windows.

%ProgramsDir%

O directório Programas do utilizador actual.

%RecentDocumentsDir%

O directório Documentos Recentes do utilizador actual.

%ResultCode%

O código de saída do cliente.

%ResultText%

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

%ReversedComputerSid%

O SID do computador em formato hexadecimal em ordem de bytes invertida.

%ReversedUserSid%

O SID do utilizador actual em formato hexadecimal em ordem de bytes invertida.

%SendToDir%

O directório Enviar para do utilizador actual.

%StartMenuDir%

O directório Menu Iniciar do utilizador actual.

%StartUpDir%

O directório Arranque do utilizador actual.

%SystemDir%

O directório do sistema Windows.

%SystemDrive%

O nome da unidade a partir da qual é executado o sistema operativo.

%TempDir%

O directório Temp do utilizador actual conforme determinado pela API do Windows.

%TimeStamp%

O carimbo de data/hora das configurações a implementar.

%TraceFile%

O caminho/nome do ficheiro de rastreio.

%WindowsDir%

O directório Windows.

As extensões de preferência fornecem uma lista de variáveis a partir da qual poderá optar por inserir em caixas de texto. Pode abrir a caixa de diálogo de qualquer caixa de texto que:

  • Não esteja desactivada.

  • Não seja só de leitura.

  • Não esteja restringida a um valor numérico.

Para introduzir uma variável

  1. Abra a Consola de Gestão de Políticas de Grupo. Clique com o botão direito do rato no objecto de Política de Grupo (GPO) que contém o item de preferência que pretende configurar e, em seguida, clique em Editar.

  2. Coloque o cursor na caixa pretendida.

    • Para introduzir uma variável de processo de preferência, prima F3, seleccione uma variável a partir da lista e, em seguida, clique em Seleccionar para inserir a variável na caixa.

    • Para introduzir uma variável de ambiente do Windows existente, escreva a variável na caixa.

      Nota

      Pode impedir a resolução de uma variável antes de ser aplicada aos computadores cliente (para que seja apresentada a variável na definição de preferência nos computadores cliente em vez do valor resolvido). Para efectuar esta acção para uma variável de processo de preferência, desmarque a caixa de verificação Resolver Variável. Deste modo, é inserido <> entre os delimitadores % % e o nome da variável (por exemplo, %<ProgramFiles>%). As extensões de preferência removem os caracteres < > do texto e mantêm a variável não resolvida. Também pode utilizar esta sintaxe com uma variável de ambiente do Windows.

Referências adicionais

Sumário