Start-Process

Odwołanie

Moduł:: Microsoft.PowerShell.Management

Uruchamia co najmniej jeden proces na komputerze lokalnym.

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

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-WorkingDirectory <string>]
     [-PassThru]
     [-Verb <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [<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`""

Parametry

-ArgumentList

Określa parametry lub wartości parametrów do użycia podczas uruchamiania tego polecenia cmdlet. Argumenty mogą być akceptowane jako pojedynczy ciąg z argumentami oddzielonymi spacjami lub jako tablica ciągów oddzielonych przecinkami. Polecenie cmdlet łączy tablicę w jeden ciąg z każdym elementem tablicy oddzielonym pojedynczą spacją.

Zewnętrzne cudzysłowy ciągów programu PowerShell nie są uwzględniane, gdy wartości ArgumentList są przekazywane do nowego procesu. Jeśli parametry lub wartości parametrów zawierają spację lub cudzysłów, muszą być otoczone znakiem ucieczki podwójnych cudzysłowów. Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

Aby uzyskać najlepsze wyniki, użyj pojedynczej wartości ArgumentList zawierającej wszystkie argumenty i wszelkie wymagane znaki cudzysłowu.

Typ:	String[]
Aliasy:	Args
Position:	1
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Domyślnie polecenie cmdlet używa poświadczeń bieżącego użytkownika.

Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential wygenerowany przez Get-Credential polecenie cmdlet. Jeśli wpiszesz nazwę użytkownika, zostanie wyświetlony monit o wprowadzenie hasła.

Poświadczenia są przechowywane w obiekcie PSCredential , a hasło jest przechowywane jako secureString.

Uwaga

Aby uzyskać więcej informacji na temat ochrony danych SecureString , zobacz Jak bezpieczny jest protokół SecureString?.

Typ:	PSCredential
Aliasy:	RunAs
Position:	Named
Domyślna wartość:	Current user
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FilePath

Określa opcjonalną ścieżkę i nazwę pliku programu uruchamianego w procesie. Wprowadź nazwę pliku wykonywalnego lub dokumentu, takiego jak .txt plik lub .doc , który jest skojarzony z programem na komputerze. Ten parametr jest wymagany.

Jeśli określisz tylko nazwę pliku, użyj parametru WorkingDirectory , aby określić ścieżkę.

Typ:	String
Aliasy:	PSPath
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-LoadUserProfile

Wskazuje, że to polecenie cmdlet ładuje profil użytkownika systemu Windows przechowywany w kluczu HKEY_USERS rejestru dla bieżącego użytkownika.

Ten parametr nie ma wpływu na profile programu PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.

Typ:	SwitchParameter
Aliasy:	Lup
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-NoNewWindow

Uruchom nowy proces w bieżącym oknie konsoli. Domyślnie w systemie Windows program PowerShell otwiera nowe okno.

Nie można użyć parametrów NoNewWindow i WindowStyle w tym samym poleceniu.

Typ:	SwitchParameter
Aliasy:	nnw
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-PassThru

Zwraca obiekt procesu dla każdego procesu, który został uruchomiony przez polecenie cmdlet. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RedirectStandardError

Określa plik. To polecenie cmdlet wysyła wszelkie błędy wygenerowane przez proces do określonego pliku. Wprowadź ścieżkę i nazwę pliku. Domyślnie błędy są wyświetlane w konsoli programu .

Typ:	String
Aliasy:	RSE
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RedirectStandardInput

Określa plik. To polecenie cmdlet odczytuje dane wejściowe z określonego pliku. Wprowadź ścieżkę i nazwę pliku wejściowego. Domyślnie proces pobiera dane wejściowe z klawiatury.

Typ:	String
Aliasy:	RSI
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RedirectStandardOutput

Określa plik. To polecenie cmdlet wysyła dane wyjściowe wygenerowane przez proces do określonego pliku. Wprowadź ścieżkę i nazwę pliku. Domyślnie dane wyjściowe są wyświetlane w konsoli programu .

Typ:	String
Aliasy:	RSO
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-UseNewEnvironment

Wskazuje, że to polecenie cmdlet używa nowych zmiennych środowiskowych określonych dla tego procesu. Domyślnie rozpoczęty proces jest uruchamiany ze zmiennymi środowiskowymi dziedziczone z procesu nadrzędnego.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Verb

Określa czasownik, który ma być używany, gdy to polecenie cmdlet uruchamia proces. Dostępne czasowniki są określane przez rozszerzenie nazwy pliku, który jest uruchamiany w procesie.

W poniższej tabeli przedstawiono czasowniki dla niektórych typowych typów plików procesów.

Typ pliku	zlecenia
cmd	`Edit`, , `Open`, `Print`, , `RunAsRunAsUser`
.exe	`Open`, , `RunAsRunAsUser`
txt	`Open`, , `PrintPrintTo`
.wav	`Open`, `Play`

Aby znaleźć czasowniki, których można użyć z plikiem uruchomionym w procesie, użyj New-Object polecenia cmdlet , aby utworzyć obiekt System.Diagnostics.ProcessStartInfo dla pliku. Dostępne czasowniki znajdują się we właściwości Verbs obiektu ProcessStartInfo. Aby uzyskać szczegółowe informacje, zobacz przykłady.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Wait

Wskazuje, że to polecenie cmdlet oczekuje na ukończenie określonego procesu i jego elementów podrzędnych przed zaakceptowaniem większej liczby danych wejściowych. Ten parametr pomija wiersz polecenia lub zachowuje okno do momentu zakończenia procesów.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WindowStyle

Określa stan okna używanego dla nowego procesu. Domyślna wartość to Normal. Dopuszczalne wartości tego parametru to:

Normal
Hidden
Minimized
Maximized

Nie można użyć parametrów WindowStyle i NoNewWindow w tym samym poleceniu.

Typ:	ProcessWindowStyle
Dopuszczalne wartości:	Normal, Hidden, Minimized, Maximized
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WorkingDirectory

Określa lokalizację, w którą powinien zostać uruchomiony nowy proces. Wartość domyślna to lokalizacja uruchamianego pliku wykonywalnego lub dokumentu. Symbole wieloznaczne nie są obsługiwane. Ścieżka nie może zawierać znaków interpretowanych jako symbole wieloznaczne.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

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 Windows PowerShell zawiera następujące aliasy dla programu Start-Process:

saps
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.

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).

Udostępnij za pośrednictwem

Start-Process

Składnia

Opis

Przykłady

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

Przykład 2. Drukowanie pliku tekstowego

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

Przykład 4. Uruchamianie procesu w zmaksymalizowanym oknie

Przykład 5. Uruchamianie programu PowerShell jako administrator

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

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

Parametry

-ArgumentList

-Credential

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WindowStyle

-WorkingDirectory

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Start-Process

Składnia

Opis

Przykłady

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

Przykład 2. Drukowanie pliku tekstowego

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

Przykład 4. Uruchamianie procesu w zmaksymalizowanym oknie

Przykład 5. Uruchamianie programu PowerShell jako administrator

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

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

Parametry

-ArgumentList

-Credential

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WindowStyle

-WorkingDirectory

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby