Запускает один или несколько процессов на локальном компьютере.
Синтаксис
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>]
Описание
Запускает один или несколько процессов на локальном компьютере. Чтобы указать программу, выполняемую в процессе, введите исполняемый файл или файл скрипта, либо файл, который может быть открыт с помощью имеющейся на компьютере программы. Если указанный файл не является исполняемым, командлет Start-Process запускает связанную с этим файлом программу, подобно командлету Invoke-Item.
Параметры командлета Start-Process можно использовать для задания параметров запуска, таких как загрузка профиля пользователя, запуск процесса в новом окне или использование других учетных данных.
Параметры
-ArgumentList <string[]>
Задает параметры или значения параметров, используемые при запуске процесса. Имя параметра ("Arguments") указывать необязательно.
|
Обязательно? |
false |
|
Позиция? |
2 |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, возвращаемый командлетом Get-Credential. По умолчанию командлет использует учетные данные текущего пользователя.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
Current user. |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-FilePath <string>
Задает путь (необязательно) и имя файла программы, выполняемой в процессе. Введите имя исполняемого файла или документа, такого как TXT- или DOC-файл, связанного с имеющейся на компьютере программой. Это обязательный параметр.
При указании только имени файла необходимо использовать параметр WorkingDirectory для задания пути.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-LoadUserProfile
Загружает профиль пользователя Windows, хранящийся в разделе реестра HKEY_USERS для текущего пользователя. По умолчанию используется значение FALSE.
Этот параметр не влияет на профили Windows PowerShell. (См. раздел about_Profiles.)
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-NoNewWindow
Предотвращает запуск процесса в новом окне. По умолчанию процесс выполняется в новом окне.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-PassThru
Возвращает объект процесса для каждого запущенного командлетом процесса. По умолчанию этот командлет не формирует никаких выходных данных.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-RedirectStandardError
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-RedirectStandardInput <string>
Считывает входные данные из указанного файла. Введите путь и имя входного файла. По умолчанию процесс получает входные данные с клавиатуры.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
Keyboard |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-RedirectStandardOutput <string>
Отправляет формируемые процессом выходные данные в указанный файл. Введите путь и имя файла. По умолчанию выходные данные отображаются в консоли.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
FALSE |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-UseNewEnvironment
Указывает командлету использовать новые переменные среды, заданные для процесса. По умолчанию запущенный процесс выполняется с переменными среды, заданными для компьютера и пользователя.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Verb <string>
Задает команду, используемую при запуске процесса, такую как Edit, Open или Print.
С каждым типом файлов связан набор команд, которые можно использовать. Чтобы определить команды, которые можно использовать в сочетании с данным процессом, используйте свойство Verbs объекта.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Wait
Ожидает завершения указанного процесса, прежде чем принимать следующий ввод. Этот параметр отключает командую строку или удерживает окно до завершения процесса.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WindowStyle <ProcessWindowStyle>
Задает состояние окон, используемых для выполнения процесса. Допустимые значения: Normal, Hidden, Minimized и Maximized. По умолчанию используется значение "Normal".
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
Normal |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WorkingDirectory <string>
Задает местоположение исполняемого файла, выполняемого в процессе, или обрабатываемого документа. По умолчанию используется текущий каталог.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
Current directory |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
Нет Данные невозможно передать командлету Start-Process по конвейеру. |
|
Выходные данные |
Нет или System.Diagnostics.Process Если задан параметр PassThru, командлет Start-Process формирует объект System.Diagnostics.Process. В противном случае этот командлет не возвращает никаких выходных данных. |
Примечания
Этот командлет реализован с использованием метода Start класса System.Diagnostics.Process. Дополнительные сведения об этом методе см. в разделе "Метод Process.Start" библиотеки MSDN (Microsoft Developer Network) по адресу (на английском языке).
Пример 1
C:\PS>start-process sort.exe Описание ----------- Эта команда запускает процесс, использующий файл Sort.exe в текущем каталоге. Все используемые значения, включая стиль окна, рабочий каталог и учетные данные, представляют собой значения по умолчанию.
Пример 2
C:\PS>start-process myfile.txt -workingdirectory "C:\PS-Test" -verb Print Описание ----------- Эта команда запускает процесс, который выводит на печать файл C:\PS-Test\MyFile.txt.
Пример 3
C:\PS>start-process Sort.exe -RedirectStandardInput Testsort.txt -RedirectStandardOutput Sorted.txt -RedirectStandardError SortError.txt -UseNewEnvironment Описание ----------- Эта команда запускает процесс, который сортирует элементы в файле Testsort.txt и возвращает отсортированные элементы в файле Sorted.txt. Все ошибки записываются в файл SortError.txt. Параметр UseNewEnvironment указывает, что этот процесс выполняется с собственными переменными среды.
Пример 4
C:\PS>start-process notepad -wait -windowstyle Maximized Описание ----------- Эта команда запускает процесс Notepad. Окно разворачивается во весь экран и удерживается до завершения процесса.