setx

Cria ou modifica variáveis de ambiente no ambiente do usuário ou do sistema, sem a necessidade de programação ou script. O comando Setx também recupera os valores das chaves do Registro e os grava em arquivos de texto.

Sintaxe

setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable> <value> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable>] /k <path> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] /f <filename> {[<variable>] {/a <X>,<Y> | /r <X>,<Y> <String>} [/m] | /x} [/d <delimiters>]

Parâmetros

Comentários

• Esse comando é semelhante ao utilitário UNIX SETENV.

• Você pode usar esse comando a fim de definir valores para variáveis de ambiente do usuário e do sistema de uma das três fontes (modos): Modo de Linha de Comando, Modo de Registro ou Modo de Arquivo.

• Esse comando grava variáveis no ambiente mestre no registro. Variáveis definidas com variáveis setx ficam disponíveis apenas em janelas de comando futuras, não na janela de comando atual.

• HKEY_CURRENT_USER e HKEY_LOCAL_MACHINE são os únicos hives com suporte. REG_DWORD, REG_EXPAND_SZ, REG_SZ e REG_MULTI_SZ são os tipos de dados RegKey válidos.

• Se você obtiver acesso a valores REG_MULTI_SZ no registro, somente o primeiro item será extraído e usado.

• Você não pode usar esse comando para remover valores adicionados aos ambientes locais ou do sistema. Você pode usar esse comando com um nome de variável e sem valor para remover um valor correspondente do ambiente local.

• Os valores do registro REG_DWORD são extraídos e usados no modo hexadecimal.

• O modo de arquivo dá suporte apenas à análise de arquivos de texto CRLF (retorno de carro e alimentação de linha).

• A execução desse comando em uma variável existente remove todas as referências de variáveis e usa valores expandidos.

  Por exemplo, se a variável %PATH% tiver uma referência a %JAVADIR%, e %PATH% for manipulada usando setx, %JAVADIR% será expandida e seu valor será atribuído diretamente à variável de destino %PATH%. Isso significa que as atualizações futuras para %JAVADIR% não serão refletidas na variável %PATH%.

• Lembre-se de que há um limite de 1024 caracteres na atribuição de conteúdo a uma variável usando setx.

  Isso significa que o conteúdo será cortado se você ultrapassar 1024 caracteres e que o texto cortado é o que é aplicado à variável de destino. Se esse texto cortado for aplicado a uma variável existente, isso poderá resultar na perda de dados anteriormente mantidos pela variável de destino.

Exemplos

Para definir a variável de ambiente MACHINE no ambiente local com o valor Brand1, digite:

setx MACHINE Brand1

Para definir a variável de ambiente MACHINE no ambiente do sistema com o valor Brand1 Computer, digite:

setx MACHINE Brand1 Computer /m

Para definir a variável de ambiente MYPATH no ambiente local e usar o caminho de pesquisa definido na variável de ambiente PATH, digite:

setx MYPATH %PATH%

Para definir a variável de ambiente MYPATH no ambiente local e usar o caminho de pesquisa definido na variável de ambiente PATH depois de substituir ~ por %, digite:

setx MYPATH ~PATH~

Para definir a variável de ambiente MACHINE no ambiente local como Brand1 em um computador remoto chamado computer1, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1

Para definir a variável de ambiente MYPATH no ambiente local e usar o caminho de pesquisa definido na variável de ambiente PATH em um computador remoto chamado computer1, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%

Para definir a variável de ambiente TZONE no ambiente local com o valor encontrado na chave do Registro HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, digite:

setx TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

Para definir a variável de ambiente TZONE no ambiente local de um computador remoto chamado computer1 com o valor encontrado na chave do registro HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

Para definir a variável de ambiente BUILD no ambiente do sistema com o valor encontrado na chave do registro HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, digite:

setx BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber /m

Para definir a variável de ambiente BUILD no ambiente do sistema de um computador remoto chamado Computer1 com o valor encontrado na chave do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23  BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber /m

Para exibir o conteúdo de um arquivo chamado Ipconfig.out, juntamente com as coordenadas correspondentes do conteúdo, digite:

setx /f ipconfig.out /x

Para definir a variável de ambiente IPADDR no ambiente local com o valor encontrado na coordenada 5,11 no arquivo Ipconfig.out, digite:

setx IPADDR /f ipconfig.out /a 5,11

Para definir a variável de ambiente OCTET1 no ambiente local com o valor encontrado na coordenada 5,3 no arquivo Ipconfig.out com delimitadores #$*., digite:

setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.

Para definir a variável de ambiente IPGATEWAY no ambiente local com o valor encontrado na coordenada 0,7 em relação à coordenada do Gateway no arquivo Ipconfig.out, digite:

setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway

Para exibir o conteúdo do arquivo Ipconfig.out, juntamente com as coordenadas correspondentes do conteúdo, em um computador chamado computer1, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x

Links relacionados

• Chave da sintaxe de linha de comando