共用方式為


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

Description

Cmdlet 會在 Start-Process 本機計算機上啟動一或多個進程。 根據預設, Start-Process 會建立新的進程,以繼承目前進程中定義的所有環境變數。

若要指定在進程中執行的程式,請輸入可執行檔或腳本檔案,或可在計算機上使用程式開啟的檔案。 如果您指定非可執行檔, Start-Process 請啟動與檔案相關聯的程式,類似於 Invoke-Item Cmdlet。

您可以使用 的參數 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.txtUseNewEnvironment 參數會指定進程以自己的環境變數執行。

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

此範例會使用 Splatting 將參數傳遞至 Cmdlet。 如需詳細資訊,請參閱 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 進程中執行的檔案。 ProcessStartInfo 物件的 Verbs 屬性會顯示您可以使用 OpenRunAs verbs 搭配 powershell.exe,或搭配任何執行.exe檔案的進程。

範例 7:指定進程的自變數

這兩個 dir 命令都會啟動 Windows 命令解釋器,並在資料夾上 Program Files 發出命令。 因為這個 foldername 包含空格,因此值需要以逸出引號括住。 請注意,第一個命令會將字串指定為 ArgumentList。 第二個命令是字串數位。

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

參數

-ArgumentList

指定此 Cmdlet 啟動行程時要使用的參數或參數值。 自變數可以接受為以空格分隔的自變數的單一字串,或做為以逗號分隔的字串陣列。 Cmdlet 會將陣列聯結成單一字串,其中陣列的每個元素都會以單一空格分隔。

當 ArgumentList 值傳遞至新進程時,不會包含 PowerShell 字串的外部引號。 如果參數或參數值包含空格或引號,則必須以逸出雙引弧括住。 如需詳細資訊,請參閱 about_Quoting_Rules

為了獲得最佳結果,請使用包含所有自變數和任何所需引號字元的單 一 ArgumentList 值。

類型:String[]
別名:Args
Position:1
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定具有執行此動作許可權的用戶帳戶。 根據預設,Cmdlet 會使用目前用戶的認證。

輸入用戶名稱,例如User01或Domain01\User01,或輸入 Cmdlet 所產生的 Get-Credential PSCredential 物件。 如果您輸入使用者名稱,系統會提示您輸入密碼。

認證會儲存在 PSCredential 物件中,密碼會儲存為 SecureString

注意

如需 SecureString 數據保護的詳細資訊,請參閱 SecureString 有多安全?

類型:PSCredential
別名:RunAs
Position:Named
預設值:Current user
必要:False
接受管線輸入:False
接受萬用字元:False

-FilePath

指定程式在程式中執行的選擇性路徑和檔名。 輸入與計算機上程式相關聯的可執行檔或檔名稱,例如 .txt.doc 檔案。 此為必要參數。

如果您只指定檔名,請使用 WorkingDirectory 參數來指定路徑。

類型:String
別名:PSPath
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-LoadUserProfile

指出此 Cmdlet 會載入儲存在目前使用者的登錄機碼中的 HKEY_USERS Windows 使用者設定檔。

此參數不會影響 PowerShell 配置檔。 如需詳細資訊,請參閱 about_Profiles

類型:SwitchParameter
別名:Lup
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NoNewWindow

在目前的主控台視窗中啟動新的程式。 根據預設,在 Windows 上,PowerShell 會開啟新的視窗。

您無法在相同的命令中使用 NoNewWindowWindowStyle 參數。

類型:SwitchParameter
別名:nnw
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

針對 Cmdlet 啟動的每個進程,傳回進程物件。 根據預設,此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RedirectStandardError

指定檔案。 此 Cmdlet 會將進程所產生的任何錯誤傳送至您指定的檔案。 輸入路徑和檔名。 根據預設,錯誤會顯示在控制台中。

類型:String
別名:RSE
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RedirectStandardInput

指定檔案。 此 Cmdlet 會從指定的檔案讀取輸入。 輸入輸入檔的路徑和檔名。 根據預設,進程會從鍵盤取得其輸入。

類型:String
別名:RSI
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RedirectStandardOutput

指定檔案。 此 Cmdlet 會將進程所產生的輸出傳送至您指定的檔案。 輸入路徑和檔名。 根據預設,輸出會顯示在控制台中。

類型:String
別名:RSO
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseNewEnvironment

指出此 Cmdlet 會使用為進程指定的新環境變數。 根據預設,啟動的進程會使用繼承自父進程的環境變數來執行。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Verb

指定此 Cmdlet 啟動行程時要使用的動詞。 可用的動詞是由處理程序中執行之檔案的擴展名所決定。

下表顯示一些常見進程檔類型的動詞。

檔案類型 動詞
.cmd Edit、、 OpenPrintRunAsRunAsUser
.exe Open、 、 RunAsRunAsUser
.txt Open、 、 PrintPrintTo
.wav Open, Play

若要尋找可與進程中執行的檔案搭配使用的動詞,請使用 New-Object Cmdlet 來建立 檔案的 System.Diagnostics.ProcessStartInfo 物件。 可用的動詞位於 ProcessStartInfo 物件的 Verbs 屬性中。 如需詳細資訊,請參閱範例。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Wait

表示此 Cmdlet 會先等候指定的進程及其子系完成,再接受更多輸入。 此參數會隱藏命令提示字元,或保留視窗,直到進程完成為止。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WindowStyle

指定用於新進程的窗口狀態。 預設值是 Normal。 此參數可接受的值為:

  • Normal
  • Hidden
  • Minimized
  • Maximized

您無法在 相同的命令中使用 WindowStyleNoNewWindow 參數。

類型:ProcessWindowStyle
接受的值:Normal, Hidden, Minimized, Maximized
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WorkingDirectory

指定新進程應該啟動的位置。 預設值是正在啟動之可執行檔或檔的位置。 不支援通配符。 路徑不得包含將解譯為通配符的字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

None

根據預設,此 Cmdlet 不會傳回任何輸出。

Process

當您使用 PassThru 參數時,這個 Cmdlet 會 傳回 Process 物件。

備註

Windows PowerShell 包含下列的 Start-Process別名:

  • saps
  • start

原生命令是安裝在作業系統中的可執行檔。 這些可執行檔可以從任何命令行殼層執行,例如 PowerShell。 通常,您執行命令的方式與 在 或 cmd.exebash完全相同。 Start-Process Cmdlet 可用來執行任何原生命令,但只有在您需要控制命令的執行方式時,才應該使用。

根據預設,Start-Process會以異步方式啟動進程。 即使新進程仍在執行中,控件仍會立即傳回 PowerShell。

  • 在本機系統上,啟動的進程會與呼叫程序無關。
  • 在遠端系統上,當遠端會話結束時,緊接在命令之後 Start-Process ,就會終止新進程。 因此,您無法在預期啟動的行程超過工作階段的遠端工作階段中使用 Start-Process

如果您需要在遠端會話中使用Start-Process,請使用 Wait 參數叫用它。 或者,您可以使用其他方法在遠端系統上建立新的程式。

使用 Wait 參數時, Start-Process 會等候進程樹狀結構(進程及其所有子系)在傳回控件之前結束。 這與 Cmdlet 的行為 Wait-Process 不同,Cmdlet 只會等候指定的進程結束。

在 Windows 上,最常見的使用案例 Start-Process 是使用 Wait 參數封鎖進度,直到新進程結束為止。 在非 Windows 系統上,這很少需要,因為命令行應用程式的預設行為相當於 Start-Process -Wait

這個 Cmdlet 是使用 System.Diagnostics.Process 類別的 Start 方法實作。 如需這個方法的詳細資訊,請參閱 Process.Start 方法