Start-Process
Elindít egy vagy több folyamatot a helyi számítógépen.
Syntax
Default (Alapértelmezett)
Start-Process
[-FilePath] <String>
[[-ArgumentList] <String[]>]
[-Credential <PSCredential>]
[-WorkingDirectory <String>]
[-LoadUserProfile]
[-NoNewWindow]
[-PassThru]
[-RedirectStandardError <String>]
[-RedirectStandardInput <String>]
[-RedirectStandardOutput <String>]
[-WindowStyle <ProcessWindowStyle>]
[-Wait]
[-UseNewEnvironment]
[<CommonParameters>]
UseShellExecute
Start-Process
[-FilePath] <String>
[[-ArgumentList] <String[]>]
[-WorkingDirectory <String>]
[-PassThru]
[-Verb <String>]
[-WindowStyle <ProcessWindowStyle>]
[-Wait]
[<CommonParameters>]
Description
A Start-Process parancsmag elindít egy vagy több folyamatot a helyi számítógépen. A folyamatban futó program megadásához adjon meg egy végrehajtható fájlt vagy szkriptfájlt, vagy egy olyan fájlt, amely a számítógépen egy program használatával nyitható meg. Ha nem végrehajtható fájlt ad meg, Start-Process elindítja a fájlhoz társított programot, hasonlóan a Invoke-Item parancsmaghoz.
A Start-Process paramétereivel olyan beállításokat adhat meg, mint a felhasználói profil betöltése, a folyamat új ablakban való elindítása vagy alternatív hitelesítő adatok használata.
Példák
1. példa: Alapértelmezett értékeket használó folyamat indítása
Ez a példa elindít egy folyamatot, amely az aktuális mappában lévő Sort.exe fájlt használja. A parancs az összes alapértelmezett értéket használja, beleértve az alapértelmezett ablakstílust, a munkamappát és a hitelesítő adatokat.
Start-Process -FilePath "sort.exe"
2. példa: Szövegfájl nyomtatása
Ez a példa elindít egy folyamatot, amely kinyomtatja a C:\PS-Test\MyFile.txt fájlt.
Start-Process -FilePath "myfile.txt" -WorkingDirectory "C:\PS-Test" -Verb Print
3. példa: Elemek új fájlba rendezésének folyamata
Ez a példa elindít egy folyamatot, amely a Testsort.txt fájl elemeit rendezi, és visszaadja a Sorted.txt fájlok rendezett elemeit. A rendszer minden hibát a SortError.txt fájlba ír.
Start-Process -FilePath "Sort.exe" -RedirectStandardInput "Testsort.txt" -RedirectStandardOutput "Sorted.txt" -RedirectStandardError "SortError.txt" -UseNewEnvironment
A UseNewEnvironment paraméter azt határozza meg, hogy a folyamat saját környezeti változókkal fusson.
4. példa: Folyamat indítása teljes méretű ablakban
Ez a példa elindítja a Notepad.exe folyamatot. Maximalizálja az ablakot, és megőrzi az ablakot, amíg a folyamat befejeződik.
Start-Process -FilePath "notepad" -Wait -WindowStyle Maximized
5. példa: A PowerShell indítása rendszergazdaként
Ez a példa a "Futtatás rendszergazdaként" lehetőséggel indítja el a PowerShellt.
Start-Process -FilePath "powershell" -Verb RunAs
6. példa: Folyamat indítása különböző igék használatával
Ez a példa bemutatja, hogyan keresheti meg a folyamat indításakor használható igéket. A rendelkezésre álló igéket a folyamatban futó fájl fájlnévkiterjesztése határozza meg.
$startExe = New-Object System.Diagnostics.ProcessStartInfo -Args PowerShell.exe
$startExe.verbs
open
runas
A példa New-Object használ egy System.Diagnostics.ProcessStartInfo objektum létrehozásához a PowerShell-folyamatban futó PowerShell.exeszámára. A ProcessStartInfo objektum Verbs tulajdonsága azt mutatja, hogy a Open és RunAs igéket használhatja PowerShell.exe, vagy bármely olyan folyamattal, amely egy .exe fájlt futtat.
7. példa: A folyamat argumentumainak megadása
Mindkét parancs elindítja a Windows parancsértelmezőt, és kiad egy dir parancsot a Program Files mappában. Mivel ez a mappanév szóközt tartalmaz, az értéknek szökött idézőjelekkel kell körülvennie. Vegye figyelembe, hogy az első parancs argumentumlistaként határoz meg egy sztringet. A második parancs egy sztringtömb.
Start-Process -FilePath "$env:comspec" -ArgumentList "/c dir `"%systemdrive%\program files`""
Start-Process -FilePath "$env:comspec" -ArgumentList "/c","dir","`"%systemdrive%\program files`""
Paraméterek
-ArgumentList
A parancsmag a folyamat indításakor használandó paramétereket vagy paraméterértékeket adja meg. Ha a paraméterek vagy paraméterértékek szóközt tartalmaznak, azokat szökött dupla idézőjelekkel kell körülvenni.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Argumentumok |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például egyet a Get-Credential parancsmagból. Alapértelmezés szerint a parancsmag az aktuális felhasználó hitelesítő adatait használja.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Futtatókörnyezetek |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-FilePath
Megadja a folyamatban futó program választható elérési útját és fájlnevét. Adja meg a számítógépen egy programhoz társított végrehajtható fájl vagy dokumentum nevét, például egy .txt vagy .doc fájlt. Ez a paraméter kötelező.
Ha csak egy fájlnevet ad meg, az elérési út megadásához használja a WorkingDirectory paramétert.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LoadUserProfile
Azt jelzi, hogy ez a parancsmag betölti az aktuális felhasználó HKEY_USERS beállításkulcsában tárolt Windows-felhasználói profilt.
Ez a paraméter nem befolyásolja a PowerShell-profilokat. További információért lásd: about_Profiles.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Lup |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NoNewWindow
Indítsa el az új folyamatot az aktuális konzolablakban. A PowerShell alapértelmezés szerint új ablakot nyit meg.
Ugyanabban a parancsban nem használhatja a NoNewWindow és WindowStyle paramétereket.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | nnw |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Egy folyamatobjektumot ad vissza minden olyan folyamathoz, amelyet a parancsmag elindított. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-RedirectStandardError
Egy fájlt ad meg. Ez a parancsmag elküldi a folyamat által generált hibákat egy ön által megadott fájlnak. Adja meg az elérési utat és a fájlnevet. Alapértelmezés szerint a hibák megjelennek a konzolon.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | RSE |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-RedirectStandardInput
Egy fájlt ad meg. Ez a parancsmag beolvassa a bemenetet a megadott fájlból. Adja meg a bemeneti fájl elérési útját és fájlnevét. Alapértelmezés szerint a folyamat lekéri a bemenetét a billentyűzetről.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Repetitív Megterhelésből Adódó Sérülés (RSI) |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-RedirectStandardOutput
Egy fájlt ad meg. Ez a parancsmag elküldi a folyamat által létrehozott kimenetet egy ön által megadott fájlnak. Adja meg az elérési utat és a fájlnevet. Alapértelmezés szerint a kimenet megjelenik a konzolon.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | RSO |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseNewEnvironment
Azt jelzi, hogy ez a parancsmag a folyamathoz megadott új környezeti változókat használja. Alapértelmezés szerint az elindított folyamat a számítógép és a felhasználó számára megadott környezeti változókkal fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Default
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Verb
A parancsmag a folyamat indításakor használandó igét adja meg. Az elérhető igéket a folyamatban futó fájl fájlnévkiterjesztése határozza meg.
Az alábbi táblázat néhány gyakori folyamatfájl-típushoz tartozó igéket mutatja be.
| Fájltípus | Igék |
|---|---|
| .cmd | Szerkesztés, Megnyitás, Nyomtatás, Futtatás, RunAsUser |
| .exe | Open, RunAs, RunAsUser |
| .txt | Megnyitás, Nyomtatás, Nyomtatás |
| .wav | Megnyitás, Lejátszás |
A folyamat során futó fájllal használható igék megkereséséhez a New-Object parancsmaggal hozzon létre egy System.Diagnostics.ProcessStartInfo objektumot a fájlhoz. Az elérhető igék a ProcessStartInfo objektum Verbs tulajdonságában találhatók. Részletekért lásd a példákat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
UseShellExecute
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Wait
Azt jelzi, hogy ez a parancsmag megvárja a megadott folyamatot és annak leszármazottait, mielőtt további bemenetet fogad. Ez a paraméter letiltja a parancssort, vagy megőrzi az ablakot, amíg a folyamatok befejeződnek.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WindowStyle
Az új folyamathoz használt ablak állapotát adja meg. A paraméter elfogadható értékei a következők: Normál, Rejtett, Kisméretűés Teljes. Az alapértelmezett érték Normál.
A WindowStyle és NoNewWindow paraméterek nem használhatók ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | ProcessWindowStyle |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Normal, Hidden, Minimized, Maximized |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WorkingDirectory
Megadja a folyamatban futó végrehajtható fájl vagy dokumentum helyét. Az új folyamat alapértelmezett mappája.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
None, System.Diagnostics.Process
Ez a parancsmag létrehoz egy System.Diagnostics.Process objektumot, ha megadja a PassThru paramétert. Ellenkező esetben ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
- Ez a parancsmag a System.Diagnostics.Process osztály
Start metódusával implementálható. A metódusról további információt a Process.Start metóduscímű témakörben talál.