Start-Process

Синтаксис

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-Credential <pscredential>]
     [-WorkingDirectory <string>]
     [-LoadUserProfile]
     [-NoNewWindow]
     [-PassThru]
     [-RedirectStandardError <string>]
     [-RedirectStandardInput <string>]
     [-RedirectStandardOutput <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [-UseNewEnvironment]
     [-Environment <hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-WorkingDirectory <string>]
     [-PassThru]
     [-Verb <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [-Environment <hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-Process запускает один или несколько процессов на локальном компьютере. По умолчанию Start-Process создается новый процесс, наследующий все переменные среды, определенные в текущем процессе.

Чтобы указать программу, которая выполняется в процессе, введите исполняемый файл или файл скрипта или файл, который можно открыть с помощью программы на компьютере. Если указать файл, отличный от исполняемого файла, Start-Process запускает программу, связанную с файлом, аналогично командлету Invoke-Item .

Параметры можно использовать для указания параметров Start-Process , таких как загрузка профиля пользователя, запуск процесса в новом окне или использование альтернативных учетных данных.

Примеры

Пример 1. Запуск процесса, использующего значения по умолчанию

В этом примере запускается процесс, использующий Sort.exe файл в текущей папке. Команда использует все значения по умолчанию, включая стиль окна по умолчанию, рабочую папку и учетные данные.

Start-Process -FilePath "sort.exe"

Пример 2. Печать текстового файла

В этом примере запускается процесс печати C:\PS-Test\MyFile.txt файла.

Start-Process -FilePath "myfile.txt" -WorkingDirectory "C:\PS-Test" -Verb Print

Пример 3. Запуск процесса сортировки элементов в новый файл

В этом примере запускается процесс, который сортирует элементы в TestSort.txt файле и возвращает отсортированные элементы в файлах Sorted.txt . Все ошибки записываются в SortError.txt файл. Параметр UseNewEnvironment указывает, что процесс выполняется с собственными переменными среды.

$processOptions = @{
    FilePath = "sort.exe"
    RedirectStandardInput = "TestSort.txt"
    RedirectStandardOutput = "Sorted.txt"
    RedirectStandardError = "SortError.txt"
    UseNewEnvironment = $true
}
Start-Process @processOptions

В этом примере используется splatting для передачи параметров командлету. Дополнительные сведения см. в about_Splatting.

Пример 4. Запуск процесса в развернутом окне

В этом примере запускается Notepad.exe процесс. Окно разворачивается во весь экран и удерживается до завершения процесса.

Start-Process -FilePath "notepad" -Wait -WindowStyle Maximized

Пример 5. Запуск PowerShell от имени администратора

В этом примере powerShell запускается с помощью параметра "Запуск от имени администратора ".

Start-Process -FilePath "powershell" -Verb RunAs

Пример 6. Использование различных команд для запуска процесса

В этом примере показано, как найти команды, которые можно использовать при запуске процесса. Доступные команды определяются расширением имени файла, который выполняется в процессе.

$startExe = New-Object System.Diagnostics.ProcessStartInfo -Args powershell.exe
$startExe.verbs

open
runas
runasuser

В примере используется New-Object для создания объекта System.Diagnostics.ProcessStartInfo для powershell.exeфайла, который выполняется в процессе PowerShell. Свойство Verbs объекта ProcessStartInfo показывает, что можно использовать open и RunAs verbs with powershell.exe, или с любым процессом, выполняющим .exe файл.

Пример 7. Указание аргументов для процесса

Обе команды запускают интерпретатор команд Windows, выдавая dir команду в папке Program Files . Так как это имя папки содержит пробел, значение должно быть окружено экранируемыми кавычками. Обратите внимание, что первая команда указывает строку в качестве ArgumentList. Вторая команда — это массив строк.

Start-Process -FilePath "$env:comspec" -ArgumentList "/c dir `"%SystemDrive%\Program Files`""
Start-Process -FilePath "$env:comspec" -ArgumentList "/c","dir","`"%SystemDrive%\Program Files`""

Пример 8. Создание отсоединяемого процесса в Linux

В Windows Start-Process создается независимый процесс, который продолжает работать независимо от запуска оболочки. На платформах, отличных от Windows, только что запущенный процесс присоединяется к оболочке, которая запущена. Если оболочка запуска закрыта, дочерний процесс завершается.

Чтобы избежать прекращения дочернего процесса на платформах Unix, можно объединить с Start-Process nohup. В следующем примере запускается фоновый экземпляр PowerShell в Linux, который остается в живых даже после закрытия сеанса запуска. Команда nohup собирает выходные данные в файле nohup.out в текущем каталоге.

# Runs for 2 minutes and appends output to ./nohup.out
Start-Process nohup 'pwsh -noprofile -c "1..120 | % { Write-Host . -NoNewline; sleep 1 }"'

В этом примере Start-Process выполняется команда Linux nohup , которая запускается pwsh как отсоединяемый процесс. Дополнительные сведения см. в статье nohup в Википедии.

Пример 9. Переопределение переменной среды для процесса

По умолчанию при использовании Start-Processновый процесс создается с теми же переменными среды, что и текущий сеанс. Параметр Environment можно использовать для переопределения значений этих переменных.

В этом примере переменная FOO среды добавляется в сеанс с foo значением.

В примере выполняется Start-Process три раза, возвращая значение FOO каждого раза. Первая команда не переопределяет переменную среды. Во второй команде FOO задано значение bar. В третьей команде FOO задано $nullзначение , которое удаляет его.

$env:FOO = 'foo'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO' -Environment @{
    FOO  = 'bar'
}
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO' -Environment @{
    FOO  = $null
}

foo
bar

Параметры

-ArgumentList

-Confirm

-Credential

-Environment

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WhatIf

-WindowStyle

-WorkingDirectory

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

None

По умолчанию этот командлет не возвращает выходные данные.

Process

При использовании параметра PassThru этот командлет возвращает объект Process .

Примечания

PowerShell включает следующие псевдонимы для Start-Process:

• Все платформы
  • saps
• Windows
  • start

Собственные команды — это исполняемые файлы, установленные в операционной системе. Эти исполняемые файлы можно запускать из любой оболочки командной строки, например PowerShell. Обычно команда выполняется точно так же, как в bash или cmd.exe. Командлет Start-Process можно использовать для выполнения любых собственных команд, но его следует использовать только при необходимости управлять выполнением команды.

Start-Process полезно для запуска программ графического интерфейса на платформах, отличных от Windows. Например, запустите Start-Process gedit , чтобы запустить графический текстовый редактор, распространенный в средах РАБОЧЕГО стола GNOME.

По умолчанию Start-Process запускает процесс асинхронно. Элемент управления мгновенно возвращается в PowerShell, даже если новый процесс по-прежнему запущен.

• В локальной системе запущенный процесс живет независимо от вызывающего процесса.
• В удаленной системе новый процесс завершается при завершении удаленного сеанса сразу после Start-Process выполнения команды. Поэтому вы не можете использовать Start-Process в удаленном сеансе, ожидая, что запущенный процесс перешел к сеансу.

Если необходимо использовать Start-Process в удаленном сеансе, вызовите его с параметром Wait . Кроме того, можно использовать другие методы для создания нового процесса в удаленной системе.

При использовании параметра Start-Process Wait ожидает завершения дерева обработки (процесса и всех его потомков) перед возвратом элемента управления. Это отличается от поведения командлета Wait-Process , который ожидает завершения указанных процессов.

В Windows наиболее распространенным вариантом Start-Process использования является использование параметра Wait для блокировки хода выполнения до завершения нового процесса. В системе, отличной от Windows, это редко требуется, так как поведение по умолчанию для приложений командной строки эквивалентно Start-Process -Wait.

Этот командлет реализуется с помощью метода Start класса System.Diagnostics.Process. Дополнительные сведения об этом методе см. в разделе Process.Start Method.

Связанные ссылки

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