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