Método Run

Ejecuta un programa en un proceso nuevo.

objeto.Run(cdnComando, [entEstiloVentana], [bEsperarResultado])

Argumentos

objeto: Objeto WshShell.
cdnComando: Una cadena que indica la línea de comandos que desea ejecutar. Debe incluir cualquier parámetro que desee pasar al archivo ejecutable.
entEstiloVentana: Opcional. Valor entero que indica la apariencia de la ventana de programa. Tenga en cuenta que no todos los programas utilizan esta información.
bEsperarResultado: Opcional. Valor de tipo booleano que indica si la secuencia de comandos debe esperar a que el programa termine de ejecutarse antes de continuar con la siguiente instrucción. Si el valor es true, la ejecución de la secuencia de comandos se detiene hasta que finaliza el programa y Run devuelve cualquier código de error devuelto por el programa. Si el valor es false (el valor predeterminado), el método Run devuelve el control inmediatamente después de iniciar el programa y devuelve automáticamente el valor 0 (que no se debe interpretar como un código de error).

Comentarios

El método Run devuelve un número entero. Inicia la ejecución de un programa en un proceso nuevo de Windows. Puede hacer que la secuencia de comandos espere a que finalice el programa antes de continuar. De este modo puede sincronizar la ejecución de programas y secuencias de comandos. Las variables de entorno dentro del argumento cdnComando se expanden automáticamente. Si un tipo de archivo se registra y asocia correctamente a un determinado programa, al ejecutar este método en un archivo de dicho tipo se ejecuta el programa. Por ejemplo, si instaló Word en el equipo, al ejecutar Run en un archivo *.doc se inicia Word y se carga el documento. La siguiente tabla enumera las opciones disponibles para entEstiloVentana.

entEstiloVentana	Descripción
0	Oculta la ventana y activa otra.
1	Activa y muestra una ventana. Si la ventana está minimizada o maximizada, el sistema la restaura con su posición y tamaño originales. Una aplicación debe especificar este indicador cuando muestre la ventana por primera vez.
2	Activa la ventana y la muestra minimizada.
3	Activa la ventana y la muestra maximizada.
4	Muestra una ventana con su tamaño y posición más recientes. La ventana activa permanece activa.
5	Activa la ventana y la muestra con su tamaño y posición actuales.
6	Minimiza la ventana especificada y activa la siguiente ventana de mayor nivel en orden Z.
7	Muestra la ventana minimizada. La ventana activa permanece activa.
8	Muestra la ventana en su estado actual. La ventana activa permanece activa.
9	Activa y muestra la ventana. Si la ventana está minimizada o maximizada, el sistema la restaura con su posición y tamaño originales. Una aplicación debe especificar este indicador cuando se restaure una ventana minimizada.
10	Establece el estado de presentación a partir del estado del programa que inició la aplicación.

Ejemplo 1

El siguiente código de VBScript abre en el Bloc de notas una copia de la secuencia de comandos que se está ejecutando.

Set WshShell = WScript.CreateObject("WScript.Shell")
WshShell.Run ("%windir%\notepad" & WScript.ScriptFullName)

El siguiente código de VBScript realiza la misma función, pero especifica el tipo de ventana, espera a que el usuario cierre el Bloc de notas y guarda el código de error que devuelve esta aplicación al cerrarse.

Set WshShell = WScript.CreateObject("WScript.Shell")
Return = WshShell.Run("notepad " & WScript.ScriptFullName, 1, true)

Ejemplo 2

El siguiente código de VBScript abre una ventana de comandos, cambia la ruta a C:\ y ejecuta el comando DIR.

Dim oShell
Set oShell = WScript.CreateObject ("WSCript.shell")
oShell.run "cmd /K CD C:\ & Dir"
Set oShell = Nothing

Consulte también

Objeto WshShell