setx
Crea o modifica variables de entorno en el entorno de usuario o sistema, sin necesidad de programación ni scripting. El comando Setx también recupera los valores de las claves del Registro y los escribe en archivos de texto.
Nota:
Este comando proporciona la única forma de línea de comandos o mediante programación para establecer de forma directa y permanente los valores de entorno del sistema. Las variables de entorno del sistema se pueden configurar manualmente mediante panel de control o a través de un editor del Registro. El establece comando, que es interno para el intérprete de comandos (Cmd.exe), establece las variables de entorno de usuario solo para la ventana de consola actual.
Sintaxis
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
Parámetro | Descripción |
---|---|
/s <computer> |
Especifica el nombre o la dirección IP de un equipo remoto. No use barras diagonales inversas. El valor predeterminado es el nombre del equipo local. |
/u [<domain>\]<user name> |
Ejecuta el script con las credenciales de la cuenta de usuario especificada. El valor predeterminado es los permisos del sistema. |
/p [<password> ] |
Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. |
<variable> |
Especifica el nombre de la variable de entorno que desea establecer. |
<value> |
Especifica el valor al que desea establecer la variable de entorno. |
/k <path> |
Especifica que la variable se establece en función de la información de una clave del Registro. El ruta de acceso usa la sintaxis siguiente: \\<HIVE>\<KEY>\...\<Value> . Por ejemplo, puede especificar la siguiente ruta de acceso: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName |
/f <filename> |
Especifica el archivo que desea usar. |
/a <X>,<Y> |
Especifica coordenadas absolutas y desplazamiento como parámetros de búsqueda. |
/r <X>,<Y> <String> |
Especifica coordenadas relativas y desplazamiento de cadena como parámetros de búsqueda. |
/m | Especifica para establecer la variable en el entorno del sistema. La configuración predeterminada es el entorno local. |
/x | Muestra las coordenadas de archivo, ignorando las opciones de línea de comandos de /a, /ry /d. |
/d <delimiters> |
Especifica delimitadores como , o \ que se usarán además de los cuatro delimitadores integrados: SPACE, TAB, ENTER y LINEFEED. Los delimitadores válidos incluyen cualquier carácter ASCII. El número máximo de delimitadores es 15, incluidos los delimitadores integrados. |
/? | Muestra ayuda en el símbolo del sistema. |
Observaciones
Este comando es similar a la utilidad DE UNIX SETENV.
Puede usar este comando para establecer valores para las variables de entorno del usuario y del sistema de uno de los tres orígenes (modos): modo de línea de comandos, modo de registro o modo de archivo.
Este comando escribe variables en el entorno maestro en el Registro. Las variables establecidas con setx variables solo están disponibles en futuras ventanas de comandos, no en la ventana de comandos actual.
HKEY_CURRENT_USER y HKEY_LOCAL_MACHINE son los únicos subárboles admitidos. REG_DWORD, REG_EXPAND_SZ, REG_SZ y REG_MULTI_SZ son los tipos de datos regKey válidos.
Si obtiene acceso a REG_MULTI_SZ valores en el Registro, solo se extrae y usa el primer elemento.
No puede usar este comando para quitar los valores agregados a los entornos locales o del sistema. Puede usar este comando con un nombre de variable y ningún valor para quitar un valor correspondiente del entorno local.
REG_DWORD los valores del Registro se extraen y se usan en modo hexadecimal.
El modo de archivo solo admite el análisis de archivos de texto de retorno de carro y avance de línea (CRLF).
Al ejecutar este comando en una variable existente, se quitan las referencias de variable y se usan valores expandidos.
Por ejemplo, si la variable %PATH% tiene una referencia a %JAVADIR%y %PATH% se manipula mediante setx, %JAVADIR% se expande y su valor se asigna directamente a la variable de destino %PATH%. Esto significa que las actualizaciones futuras de %JAVADIR% no se reflejarán en la variable %PATH%.
Tenga en cuenta que hay un límite de 1024 caracteres al asignar contenido a una variable mediante setx.
Esto significa que el contenido se recorta si supera los 1024 caracteres y que el texto recortado es lo que se aplica a la variable de destino. Si este texto recortado se aplica a una variable existente, puede provocar la pérdida de datos mantenidos anteriormente por la variable de destino.
Ejemplos
Para establecer la variable de entorno MACHINE en el entorno local en el valor Brand1, escriba:
setx MACHINE Brand1
Para establecer la variable de entorno MACHINE en el entorno del sistema en el valor Brand1 Computer, escriba:
setx MACHINE Brand1 Computer /m
Para establecer la variable de entorno de MYPATH en el entorno local para usar la ruta de acceso de búsqueda definida en la variable de entorno path de PATH, escriba:
setx MYPATH %PATH%
Para establecer la variable de entorno MYPATH en el entorno local para usar la ruta de acceso de búsqueda definida en la variable de entorno path de PATH después de reemplazar ~ por %, escriba:
setx MYPATH ~PATH~
Para establecer la variable de entorno MACHINE en el entorno local en Brand1 en un equipo remoto denominado computer1, escriba:
setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1
Para establecer la variable de entorno de MYPATH en el entorno local para usar la ruta de acceso de búsqueda definida en la variable de entorno PATH de PATH en un equipo remoto denominado computer1, escriba:
setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%
Para establecer la variable de entorno TZONE de en el entorno local en el valor que se encuentra en la clave del Registro de HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, escriba:
setx TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
Para establecer la variable de entorno TZONE de en el entorno local de un equipo remoto denominado computer1 en el valor que se encuentra en la clave del Registro de HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, escriba:
setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
Para establecer la variable de entorno BUILD en el entorno del sistema en el valor que se encuentra en la clave del Registro de HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, escriba:
setx BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber /m
Para establecer la variable de entorno BUILD en el entorno del sistema de un equipo remoto denominado Computer1 en el valor que se encuentra en la clave del Registro de HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, escriba:
setx /s computer1 /u maindom\hiropln /p p@ssW23 BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber /m
Para mostrar el contenido de un archivo denominado Ipconfig.out, junto con las coordenadas correspondientes del contenido, escriba:
setx /f ipconfig.out /x
Para establecer la variable de entorno IPADDR de en el entorno local en el valor que se encuentra en la coordenada 5,11 en el archivo Ipconfig.out, escriba:
setx IPADDR /f ipconfig.out /a 5,11
Para establecer la variable de entorno de OCTET1 de en el entorno local en el valor que se encuentra en la coordenada 5,3 en el archivo ipconfig.out de con delimitadores #$*., escriba:
setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.
Para establecer la variable de entorno IPGATEWAY de en el entorno local en el valor que se encuentra en la coordenada 0,7 con respecto a la coordenada de Gateway en el archivo Ipconfig.out, escriba:
setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway
Para mostrar el contenido del archivo Ipconfig.out, junto con las coordenadas correspondientes del contenido, en un equipo denominado computer1, escriba:
setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x