Start-Process

Składnia

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>]

Opis

Polecenie Start-Process cmdlet uruchamia co najmniej jeden proces na komputerze lokalnym. Domyślnie Start-Process tworzy nowy proces, który dziedziczy wszystkie zmienne środowiskowe zdefiniowane w bieżącym procesie.

Aby określić program uruchamiany w procesie, wprowadź plik wykonywalny lub plik skryptu albo plik, który można otworzyć przy użyciu programu na komputerze. Jeśli określisz plik nie wykonywalny, Start-Process uruchom program skojarzony z plikiem, podobnie jak polecenie Invoke-Item cmdlet .

Możesz użyć parametrów Start-Process , aby określić opcje, takie jak ładowanie profilu użytkownika, uruchamianie procesu w nowym oknie lub używanie poświadczeń alternatywnych.

Przykłady

Przykład 1. Uruchamianie procesu używającego wartości domyślnych

W tym przykładzie rozpoczyna się proces, który używa Sort.exe pliku w bieżącym folderze. Polecenie używa wszystkich wartości domyślnych, w tym domyślnego stylu okna, folderu roboczego i poświadczeń.

Start-Process -FilePath "sort.exe"

Przykład 2. Drukowanie pliku tekstowego

W tym przykładzie rozpoczyna się proces, który drukuje C:\PS-Test\MyFile.txt plik.

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

Przykład 3. Rozpoczęcie procesu sortowania elementów do nowego pliku

W tym przykładzie rozpoczyna się proces, który sortuje elementy w TestSort.txt pliku i zwraca posortowane elementy w plikach Sorted.txt . Wszelkie błędy są zapisywane w SortError.txt pliku. Parametr UseNewEnvironment określa, że proces jest uruchamiany z własnymi zmiennymi środowiskowymi.

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

W tym przykładzie użyto splattingu, aby przekazać parametry do polecenia cmdlet. Aby uzyskać więcej informacji, zobacz about_Splatting.

Przykład 4. Uruchamianie procesu w zmaksymalizowanym oknie

W tym przykładzie rozpoczyna się Notepad.exe proces. Maksymalizuje okno i zachowuje okno do momentu zakończenia procesu.

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

Przykład 5. Uruchamianie programu PowerShell jako administrator

W tym przykładzie program PowerShell jest uruchamiany przy użyciu opcji Uruchom jako administrator .

Start-Process -FilePath "powershell" -Verb RunAs

Przykład 6. Uruchamianie procesu przy użyciu różnych czasowników

W tym przykładzie pokazano, jak znaleźć czasowniki, które mogą być używane podczas uruchamiania procesu. Dostępne czasowniki są określane przez rozszerzenie nazwy pliku, który jest uruchamiany w procesie.

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

open
runas
runasuser

W tym przykładzie użyto New-Object metody do utworzenia obiektu System.Diagnostics.ProcessStartInfo dla powershell.exepliku uruchamianego w procesie programu PowerShell. Właściwość Verbs obiektu ProcessStartInfo pokazuje, że można użyć czasowników Open i RunAs z powershell.exe, lub z dowolnym procesem.exe, który uruchamia plik.

Przykład 7. Określanie argumentów procesu

Oba polecenia uruchamiają interpreter poleceń systemu Windows, wydając dir polecenie w folderze Program Files . Ponieważ ta nazwa folderu zawiera spację, wartość musi być otoczona cudzysłowami ucieczki. Należy pamiętać, że pierwsze polecenie określa ciąg jako ArgumentList. Drugie polecenie to tablica ciągów.

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

Przykład 8. Tworzenie procesu odłączonego w systemie Linux

W systemie Windows tworzy niezależny proces, Start-Process który pozostaje uruchomiony niezależnie od powłoki uruchamiania. Na platformach innych niż Windows nowo uruchomiony proces jest dołączony do uruchomionej powłoki. Jeśli powłoka uruchamiania zostanie zamknięta, proces podrzędny zostanie zakończony.

Aby uniknąć zakończenia procesu podrzędnego na platformach przypominających system Unix, można połączyć z Start-Process nohupprogramem . Poniższy przykład uruchamia w tle wystąpienie programu PowerShell w systemie Linux, które pozostaje aktywne nawet po zamknięciu sesji uruchamiania. Polecenie nohup zbiera dane wyjściowe w pliku nohup.out w bieżącym katalogu.

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

W tym przykładzie Start-Process uruchomiono polecenie systemu Linux nohup , które jest uruchamiane pwsh jako proces odłączony. Aby uzyskać więcej informacji, zobacz artykuł nohup w Wikipedii.

Przykład 9. Zastępowanie zmiennej środowiskowej dla procesu

Domyślnie podczas korzystania z programu Start-Processnowy proces jest tworzony z tymi samymi zmiennymi środowiskowymi co bieżąca sesja. Możesz użyć parametru Environment , aby zastąpić wartości tych zmiennych.

W tym przykładzie zmienna środowiskowa FOO jest dodawana do sesji z wartością foo .

Przykład jest uruchamiany Start-Process trzy razy, zwracając wartość FOO za każdym razem. Pierwsze polecenie nie zastępuje zmiennej środowiskowej. W drugim poleceniu FOO jest ustawiona wartość bar. W trzecim poleceniu FOO jest ustawiona wartość $null, co spowoduje jego usunięcie.

$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

Parametry

-ArgumentList

-Confirm

-Credential

-Environment

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WhatIf

-WindowStyle

-WorkingDirectory

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Process

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca obiekt Process .

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Start-Process:

• Wszystkie platformy
  • saps
• Windows:
  • start

Natywne polecenia to pliki wykonywalne zainstalowane w systemie operacyjnym. Te pliki wykonywalne można uruchamiać z dowolnej powłoki wiersza polecenia, takiej jak program PowerShell. Zazwyczaj polecenie jest uruchamiane dokładnie tak, jak w bash elemecie lub cmd.exe. Polecenie Start-Process cmdlet może służyć do uruchamiania dowolnych natywnych poleceń, ale powinno być używane tylko wtedy, gdy trzeba kontrolować sposób wykonywania polecenia.

Start-Process jest przydatny w przypadku uruchamiania programów gui na platformach innych niż Windows. Na przykład uruchom polecenie Start-Process gedit , aby uruchomić graficzny edytor tekstów wspólne dla środowisk pulpitu GNOM.

Domyślnie Start-Process uruchamia proces asynchronicznie. Kontrolka jest natychmiast zwracana do programu PowerShell, nawet jeśli nowy proces jest nadal uruchomiony.

• W systemie lokalnym uruchomiony proces jest uruchamiany niezależnie od procesu wywoływania.
• W systemie zdalnym nowy proces zostanie zakończony po zakończeniu sesji zdalnej bezpośrednio po wykonaniu Start-Process polecenia . W związku z tym nie można używać Start-Process w sesji zdalnej, która oczekuje, że uruchomiony proces przeżyje sesję.

Jeśli musisz użyć Start-Process w sesji zdalnej, wywołaj ją za pomocą parametru Wait . Możesz też użyć innych metod, aby utworzyć nowy proces w systemie zdalnym.

W przypadku korzystania z parametru Start-Process Wait czeka na zakończenie drzewa procesów (proces i wszystkie jego elementy podrzędne) przed zwróceniem kontrolki. Różni się to od zachowania Wait-Process polecenia cmdlet, które oczekuje tylko na zakończenie określonych procesów.

W systemie Windows najczęstszym przypadkiem Start-Process użycia jest użycie parametru Wait w celu zablokowania postępu do momentu zakończenia nowego procesu. W systemie spoza systemu Windows jest to rzadko potrzebne, ponieważ domyślne zachowanie aplikacji wiersza polecenia jest równoważne .Start-Process -Wait

To polecenie cmdlet jest implementowane przy użyciu metody Start klasy System.Diagnostics.Process. Aby uzyskać więcej informacji na temat tej metody, zobacz Process.Start Method (Metoda Process.Start).

Linki powiązane

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