Start-Process

Inicia uno o más procesos en el equipo local.

Sintaxis

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-Credential <PSCredential>] [-LoadUserProfile] [-NoNewWindow] [-PassThru] [-RedirectStandardError <string>] [-RedirectStandardInput <string>] [-RedirectStandardOutput <string>] [-UseNewEnvironment] [-Wait] [-WorkingDirectory <string>] [<CommonParameters>]

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-PassThru] [-Verb <string>] [-Wait] [-WindowStyle {<Normal> | <Hidden> | <Minimized> | <Maximized>}] [-WorkingDirectory <string>] [<CommonParameters>]

Descripción

Inicia uno o más procesos en el equipo local. Para especificar el programa que se ejecuta en el proceso, escriba un archivo ejecutable, un archivo de script o un archivo que se pueda abrir utilizando un programa en el equipo. Si especifica un archivo no ejecutable, Start-Process inicia el programa asociado al archivo, al igual que el cmdlet Invoke-Item.

Puede utilizar los parámetros de Start-Process para especificar opciones, como cargar un perfil de usuario, iniciar el proceso en una nueva ventana o utilizar credenciales alternativas.

Parámetros

-ArgumentList <string[]>

Especifica parámetros o valores de parámetro que se van a utilizar al iniciar el proceso. El nombre del parámetro ("Arguments") es opcional.

¿Requerido?	false
¿Posición?	2
Valor predeterminado	ninguno
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno del cmdlet Get-Credential. De forma predeterminada, el cmdlet utiliza las credenciales del usuario actual.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	Current user.
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-FilePath <string>

Especifica la ruta de acceso (opcional) y el nombre de archivo del programa que se ejecuta en el proceso. Escriba el nombre de un archivo ejecutable o de un documento, como un archivo .txt o .doc, que esté asociado a un programa en el equipo. Este parámetro es obligatorio.

Si especifica solo un nombre de archivo, utilice el parámetro WorkingDirectory para especificar la ruta de acceso.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-LoadUserProfile

Carga el perfil de usuario de Windows almacenado en la clave del Registro HKEY_USERS para el usuario actual. El valor predeterminado es FALSE.

Este parámetro no afecta a los perfiles de Windows PowerShell. Vea about_Profiles.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	False
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-NoNewWindow

Evita que el proceso se ejecute en una nueva ventana. De forma predeterminada, el proceso se ejecuta en una nueva ventana.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	False
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-PassThru

Devuelve un objeto de proceso para cada proceso iniciado por el cmdlet. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	False
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-RedirectStandardError <string>

Envía cualquier error generado por el proceso a un archivo que se especifique. Escriba la ruta de acceso y el nombre de archivo. De forma predeterminada, los errores se muestran en la consola.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	Errors are displayed in the console
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-RedirectStandardInput <string>

Lee la entrada del archivo especificado. Escriba la ruta de acceso y el nombre del archivo de entrada. De forma predeterminada, el proceso obtiene su entrada del teclado.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	Keyboard
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-RedirectStandardOutput <string>

Envía los resultados generados por el proceso a un archivo que se especifique. Escriba la ruta de acceso y el nombre de archivo. De forma predeterminada, los resultados se muestran en la consola.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	FALSE
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-UseNewEnvironment

Utilice nuevas variables de entorno especificadas para el proceso. De forma predeterminada, el proceso iniciado se ejecuta con las variables de entorno especificadas para el equipo y el usuario.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	False
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Verb <string>

Especifica un verbo que se va a utilizar al iniciar el proceso, como Editar, Abrir o Imprimir.

Cada tipo de archivo tiene un conjunto de verbos que se pueden utilizar. Para buscar los verbos que se pueden utilizar con el proceso, utilice la propiedad Verbs del objeto.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Wait

Espera a que el proceso especificado se complete antes de aceptar más datos de entrada. Este parámetro suprime el símbolo del sistema o mantiene la ventana hasta que el proceso se completa.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	False
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WindowStyle <ProcessWindowStyle>

Especifica el estado de las ventanas utilizadas para el proceso. Los valores válidos son Normal, Hidden, Minimized y Maximized. El valor predeterminado es Normal.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	Normal
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WorkingDirectory <string>

Especifica la ubicación del archivo ejecutable o el documento que se ejecuta en el proceso. La ubicación predeterminada es el directorio actual.

¿Requerido?	false
¿Posición?	named
Valor predeterminado	Current directory
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	Ninguno No se puede canalizar la entrada a Start-Process.
Salidas	Ninguno o System.Diagnostics.Process Cuando se utiliza el parámetro PassThru, Start-Process genera un objeto System.Diagnostics.Process. De lo contrario, este cmdlet no devuelve resultados.

Notas

Este cmdlet se implementa utilizando el método Start de la clase System.Diagnostics.Process. Para obtener más información sobre este método, vea "Process.Start Method" en MSDN (Microsoft Developer Network) Library, en https://go.microsoft.com/fwlink/?LinkId=143602.

Ejemplo 1

C:\PS>start-process sort.exe

Descripción
-----------
Este comando inicia un proceso que utiliza el archivo Sort.exe del directorio actual. El comando utiliza todos los valores predeterminados, incluidos el estilo de ventana predeterminado, el directorio de trabajo y las credenciales.

Ejemplo 2

C:\PS>start-process myfile.txt -workingdirectory "C:\PS-Test" -verb Print

Descripción
-----------
Este comando inicia un proceso que imprime el archivo C:\PS-Test\MyFile.txt.

Ejemplo 3

C:\PS>start-process Sort.exe -RedirectStandardInput Testsort.txt -RedirectStandardOutput Sorted.txt -RedirectStandardError SortError.txt -UseNewEnvironment

Descripción
-----------
Este comando inicia un proceso que ordena los elementos en el archivo Testsort.txt y devuelve los elementos ordenados en los archivos Sorted.txt. Los errores se escriben en el archivo SortError.txt. 

El parámetro UseNewEnvironment especifica que el proceso se ejecuta con sus propias variables de entorno.

Ejemplo 4

C:\PS>start-process notepad -wait -windowstyle Maximized

Descripción
-----------
Este comando inicia el proceso Notepad. Maximiza la ventana y la mantiene hasta que el proceso se completa.

Vea también

Conceptos

Start-Service
Get-Process
Stop-Process
Wait-Process
Debug-Process