Compartilhar via


Tarefa SetEnv

Observação

Essa tarefa só está disponível ao usar o sistema de compilação C++.

Define ou exclui o valor de uma variável de ambiente especificada.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa SetEnv.

Parâmetro Descrição
Nome Parâmetro obrigatório String.

O nome de uma variável de ambiente.
OutputEnvironmentVariable Parâmetro de saída opcional String.

Contém o valor atribuído à variável de ambiente especificado pelo parâmetro Nome.
Prefix Parâmetro Boolean obrigatório.

Se true, concatenará o valor do parâmetro Valor antes do valor da variável de ambiente especificado pelo parâmetro Nome e, em seguida, atribuirá o resultado à variável de ambiente. Se false, atribuirá somente o valor do parâmetro Valor à variável de ambiente.
Target (destino) Parâmetro String opcional.

Especifica o local em que uma variável de ambiente é armazenada. Especifique "User" ou "Machine".

Para saber mais, confira Enumeração EnvironmentVariableTarget.
Valor Parâmetro String opcional.

O valor atribuído à variável de ambiente especificado pelo parâmetro Nome. Se Valor estiver vazio e a variável existir, a variável será excluída. Se a variável não existir, nenhum erro ocorrerá mesmo que a operação não possa ser executada.

Para saber mais, confira Método Environment::SetEnvironmentVariable.

Confira também