Archivo por lotes

En MS-DOS , un archivo por lotes se puede ejecutar desde la línea de comandos escribiendo su nombre, seguido de los parámetros necesarios y pulsando la ↵ Entertecla Intro. Al cargar DOS, el archivo AUTOEXEC.BAT , si está presente, se ejecuta automáticamente, por lo que cualquier comando necesario para configurar el entorno DOS puede incluirse en este archivo. Los usuarios de computadoras pueden configurar el archivo AUTOEXEC.BAT para establecer la fecha y hora del sistema, inicializar el entorno DOS, cargar programas residentes o controladores de dispositivos, o inicializar conexiones y asignaciones de red.

La extensión de archivo .bat identifica un archivo que contiene comandos que son ejecutados línea por línea por el intérprete de comandos COMMAND.COM , como si fuera una lista de comandos ingresados ​​manualmente, con algunos comandos adicionales específicos para archivos por lotes para funcionalidades de programación básicas, incluido un GOTOcomando para cambiar el flujo de ejecución de las líneas.

Microsoft Windows se introdujo en 1985 como una interfaz gráfica de usuario (GUI) superpuesta a sistemas operativos basados ​​en texto y fue diseñado para ejecutarse en DOS. Para iniciarlo, WINse utilizaba el comando, que podía añadirse al final del archivo AUTOEXEC.BAT para permitir la carga automática de Windows. En las versiones anteriores, se podía ejecutar un archivo de tipo .bat desde Windows en el símbolo del sistema de MS-DOS. Windows 3.1x y versiones anteriores, así como Windows 9x, utilizaban COMMAND.COM para ejecutar archivos por lotes.

El sistema operativo IBM OS/2 admitía archivos por lotes al estilo DOS. También incluía una versión de REXX , un lenguaje de scripting para archivos por lotes más avanzado . IBM y Microsoft comenzaron a desarrollar este sistema, pero durante su construcción rompieron su colaboración tras una disputa. Como resultado, IBM se refería a su consola tipo DOS sin mencionar a Microsoft, simplemente llamándola DOS, aunque esto aparentemente no afectaba el funcionamiento de los archivos por lotes desde COMMAND.COM.

El intérprete de archivos por lotes de OS/2 también admite el comando EXTPROC. Este comando pasa el archivo por lotes al programa especificado en el archivo EXTPROC como un archivo de datos. El programa especificado puede ser un archivo de script; esto es similar al mecanismo #! utilizado por los sistemas operativos tipo Unix .

A diferencia de Windows 98 y versiones anteriores, la familia de sistemas operativos Windows NT no depende de MS-DOS. Windows NT introdujo un intérprete de comandos de 32 bits mejorado ( cmd.exe ) que podía ejecutar scripts con las extensiones .CMD o .BAT. Cmd.exe añadió comandos adicionales e implementó los existentes de forma ligeramente diferente, por lo que el mismo archivo por lotes (con una extensión distinta) podía funcionar de forma diferente con cmd.exe y COMMAND.COM. En la mayoría de los casos, el funcionamiento es idéntico si no se utilizan los pocos comandos no compatibles. Las extensiones de Cmd.exe a COMMAND.COM se pueden deshabilitar para garantizar la compatibilidad.

Microsoft lanzó una versión de cmd.exe para Windows 9x y ME llamada WIN95CMD para permitir a los usuarios de versiones anteriores de Windows utilizar ciertos archivos por lotes al estilo de cmd.exe.

A partir de Windows 8cmd.exe es el intérprete de comandos normal para archivos por lotes; el antiguo COMMAND.COM también se puede ejecutar en versiones de 32 bits de Windows capaces de ejecutar programas de 16 bits. ^{[ nb 1 ]}

El intérprete ejecuta cada línea por turno, comenzando por la primera. El @símbolo al inicio de cada línea impide que el indicador muestre ese comando mientras se ejecuta. El comando ECHO OFFdesactiva el indicador de forma permanente, o hasta que se vuelva a activar. El combinado @ECHO OFFsuele ser, como aquí, la primera línea de un archivo por lotes, impidiendo que se muestren todos los comandos, incluido él mismo. A continuación, se ejecuta la siguiente línea y el ECHO Hello World!comando muestra Hello World!. Se ejecuta la siguiente línea y el PAUSEcomando muestra Press any key to continue . . .y pausa la ejecución del script. Después de pulsar una tecla, el script finaliza, ya que no hay más comandos. En Windows, si el script se ejecuta desde una ventana del símbolo del sistema ya abierta , la ventana permanece abierta en el indicador como en MS-DOS; de lo contrario, la ventana se cierra al finalizar.

Las expansiones de variables se sustituyen textualmente en el comando, por lo que las variables vacías simplemente desaparecen de la sintaxis y las que contienen espacios se convierten en múltiples tokens. Esto puede provocar errores de sintaxis o fallos.

Por ejemplo, si %foo% está vacío, esta instrucción:

SI %foo% == bar ECO Igual 

analiza como la construcción errónea:

SI ==barra ECO Igual

De manera similar, si %foo%contiene abc def, entonces se produce un error de sintaxis diferente:

SI abc def == bar ECO Igual 

La forma habitual de evitar este problema es encerrar las expansiones de variables entre comillas, de modo que una variable vacía se expanda en la expresión válida IF ""=="bar"en lugar de la inválida IF ==bar. El texto que se compara con la variable también debe ir entre comillas, ya que estas no son una sintaxis delimitadora especial; estos caracteres se representan a sí mismos.

SI " %foo% " == "bar" ECO Igual 

La expansión diferida de !VARIABLE! disponible en Windows 2000 y versiones posteriores puede utilizarse para evitar estos errores sintácticos. En este caso, las variables nulas o de varias palabras no presentan errores sintácticos porque el valor se expande después de que se analiza el comando IF:

SI !foo! == bar ECHO Igual 

Otra diferencia en Windows 2000 o superior es que una variable vacía (indefinida) no se sustituye. Como se describe en ejemplos anteriores, el comportamiento anterior del intérprete de lotes habría dado como resultado una cadena vacía. Ejemplo:

C:\> establecer MyVar = C:\> echo %MyVar% %MyVar%C:\> if " %MyVar% " == "" ( echo MyVar no está definido ) else ( echo MyVar es %MyVar% ) MyVar es %MyVar%

Los intérpretes de lotes anteriores a Windows 2000 habrían mostrado el resultado MyVar is not defined.

A diferencia de los procesos Unix/POSIX, que reciben sus argumentos de línea de comandos ya divididos por el intérprete de comandos en una matriz de cadenas, un proceso de Windows recibe la línea de comandos completa como una sola cadena, a través de la función API GetCommandLine. Como resultado, cada aplicación de Windows puede implementar su propio analizador para dividir la línea de comandos completa en argumentos. Muchas aplicaciones y herramientas de línea de comandos han desarrollado su propia sintaxis para ello, por lo que no existe una convención única para entrecomillar o escapar metacaracteres en las líneas de comandos de Windows.

• Para algunos comandos, los espacios se tratan como delimitadores que separan los argumentos, a menos que dichos espacios estén entre comillas. Existen diversas convenciones sobre cómo se pueden pasar las comillas a la aplicación:
  • Una convención ampliamente utilizada se implementa mediante el analizador de línea de comandos integrado en la biblioteca de tiempo de ejecución de Microsoft Visual C++ o en la función CommandLineToArgvW. Esta convención establece que 2n barras invertidas seguidas de comillas (") producen n barras invertidas seguidas de comillas de inicio/fin, mientras que (2n ) +1 barras invertidas seguidas de comillas producen nuevamente n barras invertidas seguidas de comillas literales. La misma convención forma parte de la especificación de .NET Framework . ^{[ 7 ]}
    • Un aspecto no documentado es que la presencia de "" en medio de una cadena entre comillas produce una sola comilla. ^{[ 7 ]} (Un cambio en la CRT en 2008 [msvcr90] modificó este manejo no documentado de las comillas. ^{[ 8 ]} ) Esto resulta útil para insertar una comilla en un argumento sin reactivar la interpretación de los metacaracteres de cmd como | , & y > . (cmd no reconoce el carácter \" habitual como escape de la comilla. Reactiva estos significados especiales al ver la comilla, pensando que la cita ha terminado).
  • Otra convención es que una comilla simple ( " ) no se incluye como parte de la cadena. Sin embargo, una comilla escapada ( """ ) puede formar parte de la cadena.
  • Otra convención común proviene del uso de programas portados derivados de Cygwin . No distingue entre barras invertidas que aparecen antes o después de las comillas. Consulte glob (programación) §  Windows y DOS para obtener información sobre estos analizadores de línea de comandos alternativos. ^{[ 9 ]}
  • Algunos comandos importantes de Windows, como cmd.exey wscript.exe, utilizan sus propias reglas. ^{[ 8 ]}
• Para otros comandos, los espacios no se tratan como delimitadores y, por lo tanto, no necesitan comillas. Si se incluyen comillas, pasan a formar parte de la cadena. Esto se aplica a algunos comandos integrados como echo .

Cuando una cadena de texto contiene comillas y debe insertarse en otra línea de texto que también debe ir entre comillas, se requiere prestar especial atención al mecanismo de comillas:

C:\> establecer foo = "esta cadena está entre comillas"C:\> echo "prueba 1 %foo% " "prueba 1 "esta cadena está entre comillas""C:\> eventcreate /T Advertencia /ID 1 /L Sistema /SO "Origen" /D "Ejemplo: %foo% " ERROR: Argumento/Opción no válido: 'cadena'. Escriba "EVENTCREATE /?" para ver su uso.

En Windows 2000 y versiones posteriores, la solución consiste en reemplazar cada aparición de un carácter de comilla dentro de un valor por una serie de tres caracteres de comilla:

C:\> establecer foo = "esta cadena está entre comillas"C:\> establecer foo = %foo:"="""%C:\> echo "prueba 1 %foo% " "prueba 1 """esta cadena está entre comillas""""C:\> eventcreate /T Advertencia /ID 1 /L Sistema /SO "Origen" /D "Ejemplo: %foo% " ÉXITO: ​​Se ha creado un evento de tipo 'Advertencia' en el registro/origen 'Origen'.

Algunos caracteres, como |el carácter de barra vertical ( ), tienen un significado especial en la línea de comandos. No se pueden imprimir como texto usando el comando ECHO a menos que se escapen usando el símbolo de intercalación ^:

C:\> echo foo | bar 'bar' no se reconoce como un comando interno o externo, programa ejecutable o archivo por lotes.C:\> echo foo ^| bar foo | bar

Sin embargo, el escape no funciona como se espera al insertar el carácter escapado en una variable de entorno. La variable termina conteniendo un comando de tubería activo cuando simplemente se muestra con echo. Es necesario escapar tanto el propio circunflejo como el carácter escapado para que el carácter se muestre como texto en la variable:

C:\> set foo = bar | baz 'baz' no se reconoce como un comando interno o externo, programa ejecutable o archivo por lotes.C:\> set foo = bar ^| baz C:\> echo %foo% 'baz' no se reconoce como un comando interno o externo, programa ejecutable o archivo por lotes.C:\> establecer foo = barra ^^^| baz C:\> echo %foo% barra | baz

La expansión retardada disponible con o con en Windows 2000 y versiones posteriores se puede utilizar para mostrar caracteres especiales almacenados en variables de entorno porque el valor de la variable se expande después de que se haya analizado el comando:

C:\> cmd /V:ON Microsoft Windows [Versión 6.1.7601] Copyright (c) 2009 Microsoft Corporation. Todos los derechos reservados.C:\> establecer foo = barra ^| baz C:\> eco !foo! barra | baz

Hasta que se introdujo el comando TIMEOUT con Windows Vista, no existía una manera sencilla de implementar una pausa programada, ya que el comando PAUSE detiene la actividad del script indefinidamente hasta que se presiona cualquier tecla.

Existían muchas soluciones alternativas, ^{[ 10 ]} pero generalmente solo funcionaban en algunos entornos: el CHOICEcomando no estaba disponible en versiones antiguas de DOS, PINGsolo estaba disponible si TCP/IP estaba instalado, etc. Microsoft no ofrecía ninguna solución, pero se podían instalar varios programas de utilidad pequeños desde otras fuentes. Un ejemplo comercial sería el comando Norton Utilities Batch Enhancer (BE) de 1988, que BE DELAY 18esperaba 1 segundo, o el WAIT.COM gratuito de 94 bytes ^{[ 11 ]} que WAIT 5esperaba 5 segundos y luego devolvía el control al script. La mayoría de estos programas son archivos .COM de 16 bits, por lo que son incompatibles con Windows de 64 bits.

Normalmente, a todo texto impreso se le añaden automáticamente los caracteres de control de retorno de carro (CR) y salto de línea (LF) al final de cada línea.

• batchtest.bat

  @ echo foo @ echo bar 

  C:\> batchtest.bat foo bar

No importa si los dos comandos echo comparten la misma línea de comandos; los códigos CR/LF se insertan para dividir la salida en líneas separadas:

C:\> @ echo Mensaje 1 &@ echo Mensaje 2 Mensaje 1 Mensaje 2

Un truco descubierto en Windows 2000 y versiones posteriores consiste en usar el mensaje especial de entrada para mostrar texto sin salto de línea (CR/LF) al final del texto. En este ejemplo, el salto de línea no sigue al Mensaje 1, pero sí a la Línea 2 y a la Línea 3:

• batchtest2.bat

  @ echo off set /p = "Mensaje 1" < nul echo Mensaje 2 echo Mensaje 3 

  C:\> batchtest2.bat Mensaje 1 Mensaje 2 Mensaje 3

Esto se puede utilizar para generar datos en un archivo de texto sin añadir CR/LF al final:

C:\> set /p = "Mensaje 1" < nul > data.txt C:\> set /p = "Mensaje 2" < nul >> data.txt C:\> set /p = "Mensaje 3" < nul >> data.txt C:\> type data.txt Mensaje 1Mensaje 2Mensaje 3

Sin embargo, no hay forma de inyectar esta salida de solicitud CR/LF eliminada directamente en una variable de entorno.

No es posible tener un símbolo del sistema que utilice una ruta UNC como directorio de trabajo actual; por ejemplo\\server\share\directory\

El símbolo del sistema requiere el uso de letras de unidad para asignar un directorio de trabajo, lo que dificulta la ejecución de archivos por lotes complejos almacenados en un recurso compartido UNC del servidor. Si bien un archivo por lotes se puede ejecutar desde una ruta de archivo UNC, el directorio de trabajo predeterminado es C:\Windows\System32\.

En Windows 2000 y versiones posteriores, una solución alternativa es usar el comando PUSHDy POPDcon extensiones de comando. ^{[ nb 2 ]}

Si no están habilitadas de forma predeterminada, las extensiones de comandos se pueden habilitar temporalmente mediante el /E:ONinterruptor del intérprete de comandos.

Para ejecutar un archivo por lotes en un recurso compartido UNC, asignar una letra de unidad temporal a dicho recurso compartido UNC y utilizarlo como directorio de trabajo, se puede crear un acceso directo de Windows con el siguiente aspecto:

• Objetivo:

El atributo de directorio de trabajo de este acceso directo se ignora.

Esto también resuelve un problema relacionado con el Control de cuentas de usuario (UAC) en Windows Vista y versiones posteriores. Cuando un administrador inicia sesión con UAC habilitado e intenta ejecutar un archivo por lotes como administrador desde una unidad de red, mediante el menú contextual del botón derecho del ratón, la operación falla inesperadamente. Esto se debe a que el contexto de cuenta con privilegios elevados de UAC no tiene asignadas letras de unidad de red, y no es posible asignar letras de unidad para el contexto elevado a través del Explorador de Windows o los scripts de inicio de sesión. Sin embargo, al crear un acceso directo al archivo por lotes con la estructura PUSHD/ mencionada anteriormente POPDy usar dicho acceso directo para ejecutar el archivo por lotes como administrador, se creará y eliminará la letra de unidad temporal en el contexto de cuenta elevada, y el archivo por lotes funcionará correctamente.

La siguiente sintaxis se expande correctamente a la ruta del script por lotes actual.

%~dp0

Las rutas UNC predeterminadas están desactivadas por defecto, ya que solían provocar fallos en programas antiguos. ^{[ 12 ]}

El valor de registro Dword DisableUNCChecken HKEY_CURRENT_USER\Software\Microsoft\Command Processor^{[ 12 ]} permite que el directorio predeterminado sea UNC. CDEl comando se negará a cambiarlo, pero puede colocar una ruta UNC en el Directorio predeterminado en un acceso directo a Cmd o usando el comando Inicio. ( C$compartir es para administradores).

Los archivos por lotes utilizan un conjunto de caracteres OEM, definido por el equipo, por ejemplo, la página de códigos 437. Las partes no ASCII de estos conjuntos de caracteres son incompatibles con los conjuntos de caracteres Unicode o Windows que se utilizan en Windows, por lo que se debe tener cuidado. ^{[ 13 ]} Los nombres de archivo que no estén en inglés solo funcionan si se introducen mediante un editor compatible con el conjunto de caracteres de DOS. Los nombres de archivo con caracteres fuera de este conjunto no funcionan en los archivos por lotes.

Para obtener un símbolo del sistema con caracteres Unicode en lugar de la página de códigos 437 o similar, se puede usar el cmd /Ucomando. En dicho símbolo del sistema, funcionará un archivo por lotes con nombres de archivo Unicode. También se puede usar cmd /Upara ejecutar directamente comandos con caracteres Unicode. Por ejemplo, crea un archivo que contiene una lista de directorios con los caracteres correctos de Windows, en la codificación UTF-16 LE.cmd /U /C dir > files.txt