Tabela de Ambiente
A tabela Ambiente é usada para definir os valores das variáveis de ambiente.
A tabela Ambiente tem as seguintes colunas.
| Coluna | Tipo | Chave | Nullable |
|---|---|---|---|
| Ambiente | identificador de | Y | N |
| Nome | de Texto | N | N |
| Valor | Formatado | N | Y |
| Componente_ | identificador de | N | N |
Colunas
-
Ambiente de
-
Essa é a chave primária da tabela e é um token não localizado.
-
Nome do
-
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 no nome. Não há nenhum 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 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 defina-a durante a instalação. Isso não terá efeito sobre o valor da variável de ambiente se ela já existir. - Remova a variável de ambiente quando o componente for removido. Esse símbolo pode ser combinado com qualquer prefixo. ! Remova a variável de ambiente durante uma instalação. O instalador só removerá 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 gravará a variável no ambiente do usuário. Esse símbolo pode ser combinado com qualquer prefixo. Um pacote usado para instalação no contexto de instalação por computador deve gravar variáveis de ambiente no ambiente do computador incluindo * na coluna Name. Para obter mais informações, consulte Comentários. =- A variável de ambiente é definida na instalação e removida na desinstalação. Esse é o comportamento normal. !- 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 será 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 esse 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 pelo caractere separador. Por exemplo, se o ponto e vírgula for o separador escolhido: [~];Value.
Para prefixar um valor na frente de uma variável existente, acrescente a cadeia de caracteres neste campo pelo caractere separador e pelo 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;de valor; [~] é mais de um valor e não deve ser usado porque causa resultados imprevisíveis. A entrada Value; [~] é apenas um valor.
Se o Nome for prefixado com +, [~] não deverá 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.
Observações
Para que o instalador defina variáveis de ambiente, a ação WriteEnvironmentStrings e ação RemoveEnvironmentStrings precisa ser listada no InstallExecuteSequence Table.
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 todo o novo caminho explicitamente no campo Valor. Em vez disso, estenda o caminho existente prefixando ou acrescentando um valor e delimitador (;) para [~]. 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 que o computador seja inicializado. A variável de caminho geralmente é definida usando a sintaxe: [~]; Valor.
Ao executar instalações por computador de um servidor de terminal, o instalador grava variáveis de ambiente por usuário para HKU\. Default\Environment. 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 computador deve gravar variáveis de ambiente no ambiente do computador incluindo * na coluna Name. Se o pacote puder ser instalado por usuário ou por computador, crie dois componentes: (1) um componente por usuário com as entradas da tabela Ambiente criadas para configurações de usuário e (2) um componente por computador com a tabela Ambiente criada para as configurações do computador. Condicione a instalação desse componente usando a propriedade Privileged.