Partilhar via


Tabela de Ambiente

A tabela Environment é usada para definir os valores das variáveis de ambiente.

A tabela Ambiente tem as seguintes colunas.

Coluna Tipo Chave Nulo
Meio Ambiente Identificador Y N
Designação de texto N N
Valor Formatado N Y
Component_ Identificador N N

Colunas

Ambiente

Esta é a chave primária da tabela e é um token não localizado.

Nome

Esta coluna é o nome localizável da variável de ambiente. Os valores de chave são gravados ou removidos dependendo de quais dos caracteres na tabela a seguir são prefixados ao nome. Não há efeito na ordenação dos símbolos usados em um prefixo.

Prefixo Descrição
= Crie a variável de ambiente se ela não existir e, em seguida, defina-a durante a instalação. Se a variável de ambiente existir, defina-a durante a instalação.
+ Crie a variável de ambiente se ela não existir e, em seguida, defina-a durante a instalação. Isso não tem efeito sobre o valor da variável de ambiente, se ela já existir.
- Remova a variável de ambiente quando o componente for removido. Este símbolo pode ser combinado com qualquer prefixo.
! Remova a variável de ambiente durante uma instalação. O instalador só remove uma variável de ambiente durante uma instalação se o nome e o valor da variável corresponderem às entradas nos campos Nome e Valor da tabela Ambiente. Se você quiser remover uma variável de ambiente, independentemente de seu valor, use a sintaxe '!' e deixe o campo Valor vazio.
* Esse prefixo é usado com o Windows 2000 para indicar que o nome se refere a uma variável de ambiente do sistema. Se nenhum asterisco estiver presente, o instalador grava a variável no ambiente do usuário. Este símbolo pode ser combinado com qualquer prefixo. Um pacote usado para instalação no contexto de instalação por máquina deve gravar variáveis de ambiente no ambiente da máquina incluindo * na coluna Nome. Para obter mais informações, consulte Observações.
=- A variável de ambiente é definida na instalação e removida na desinstalação. Este é o comportamento habitual.
!- Remove uma variável de ambiente durante uma instalação ou desinstalação.
=+ !+
!=
Estes não são prefixos válidos

Se o campo Valor na tabela incluir um [~], os caracteres de prefixo se aplicarão apenas à parte especificada da cadeia de caracteres. O uso de [~] é descrito abaixo na seção Coluna Valor.

A variável de ambiente é removida se o campo Valor da tabela estiver em branco. Portanto, com um espaço em branco no campo Valor, um prefixo = exclui a variável de ambiente na instalação e um prefixo - exclui todos os valores atuais na desinstalação.

Valor

Esta coluna contém o valor localizável que deve ser definido como uma cadeia de caracteres formatada. Consulte Formatado. Se este campo for deixado em branco, a variável será removida. Se o campo estiver em branco e a cadeia de caracteres no campo Nome for prefixada pelo símbolo -, a variável será removida somente quando o componente for removido.

Para acrescentar um valor ao final de uma variável existente, prefixe a cadeia de caracteres neste campo pelo caractere Nulo [~] e o caractere separador. Por exemplo, se o ponto-e-vírgula for o separador escolhido: [~];Valor.

Para prefixar um valor para a frente de uma variável existente, acrescente a cadeia de caracteres neste campo pelo caractere separador e o caractere Nulo [~]. Por exemplo, se o ponto-e-vírgula for o separador escolhido: Valor; [~] .

Se nenhum [~] estiver presente no campo, a cadeia de caracteres representará todo o valor a ser definido ou excluído.

Cada linha pode conter apenas um valor. Por exemplo, a entrada Valor;Valor; [~] é mais de um valor e não deve ser usado porque causa resultados imprevisíveis. A entrada Valor; [~] é apenas um valor.

Se Nome for prefixado com +, [~] não deve ser usado na coluna Valor. Isso ocorre porque o significado de "+" e "[~]" são claramente exclusivos um do outro.

Component_

Uma chave externa para a primeira coluna da tabela Componente . Esta coluna faz referência ao componente que controla a instalação dos valores de ambiente.

Comentários

Para que o instalador defina variáveis de ambiente, a ação WriteEnvironmentStrings e ação RemoveEnvironmentStrings precisam ser listadas na Tabela InstallExecuteSequence.

Observe que as variáveis de ambiente não mudam para a instalação em andamento quando a ação WriteEnvironmentStrings ou ação RemoveEnvironmentStrings são executadas. No Windows 2000, essas informações são armazenadas no registro e uma mensagem notifica o sistema de alterações quando a instalação é concluída. Um novo processo, ou outro processo que verifica essas mensagens, usa as novas variáveis de ambiente.

Ao modificar a variável de ambiente de caminho com a tabela Ambiente, não tente inserir o novo caminho inteiro explicitamente no campo Valor. Em vez disso, estenda o caminho existente prefixando ou acrescentando um valor e um delimitador (;) a [~]. Se [~] não estiver presente no campo Valor, as informações de caminho existentes serão perdidas e a instalação do arquivo .msi poderá impedir a inicialização do computador. A variável path é geralmente definida usando a sintaxe: [~]; valor.

Ao executar instalações por máquina a partir de um servidor de terminal, o instalador grava variáveis de ambiente por usuário em HKU\. Padrão\Ambiente. Como os Serviços de Terminal não replicam esta seção do Registro, a instalação não define as variáveis de ambiente por usuário. Um pacote usado para instalações por máquina deve gravar variáveis de ambiente no ambiente do computador incluindo * na coluna Nome. Se o pacote puder ser instalado por usuário ou por máquina, crie dois componentes: (1) um componente por usuário com as entradas da tabela Ambiente criadas para as configurações do usuário e (2) um componente por máquina com a tabela Ambiente criada para as configurações do computador. Condicione a instalação desse componente usando a propriedade Privileged.

Validação

ICE03
ICE06
ICE32
ICE46
ICE65
ICE69
ICE80