.set env <EnvGroupName>[(SnapshotName)] "<VariableName>=<DesiredValue>" [...]
O comando
.set desgina um valor para uma variável de ambiente. É possível especificar variáveis e valores adicionais. Insira cada variável e seu valor entre aspas. Esse comando define a variável para a captura instantânea padrão para o grupo do ambiente a menos que você especifique uma captura instantânea. Se você especificar uma captura instantânea, insira-a entre parênteses sem espaço entre o nome do grupo do ambiente e o nome da captura instantânea.
Nota: As variáveis
definidas por este comando já devem existir.
Utilize o comando .set para alterar o registro mestre de um
ambiente. Quando
o sistema executa um projeto, ele faz uma cópia do ambiente do projeto do
registro mestre, armazena a cópia dos registros de tarefas e utiliza essa cópia
como padrão do projeto.
Quando uma etapa é executada, ela utiliza a cópia da tarefa do ambiente e não o registro mestre. Portanto, o uso de .set tem os seguintes
efeitos:
- Quando um comando .set é executado em uma etapa, as
etapas posteriores que usam o ambiente da etapa padrão não veem
as mudanças. O sistema utiliza a cópia da tarefa do ambiente padrão da etapa.
- Quando um comando .set é executado em um ambiente especificado,
as etapas posteriores que especificam esse ambiente veem as mudanças feitas.
O sistema lê o registro principal do ambiente quando a etapa especifica um ambiente. Isso é verdadeiro mesmo se o ambiente da etapa especificada for o mesmo ambiente do padrão do projeto.
- As alterações feitas por um comando .set persistem após a conclusão
da tarefa. As execuções futuras usam os valores criados pelos comandos .set executados anteriormente.
Para obter informações adicionais sobre o uso desse comando, consulte Trabalhando com Dados da Tarefa.
Além disso, consulte o comando similar .bset.