Запускает один или несколько процессов на локальном компьютере.

Синтаксис

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. Окно разворачивается во весь экран и удерживается до завершения процесса.






См. также