Start-Process

模块:

Microsoft.PowerShell.Management

启动本地计算机上的一个或多个进程。

语法

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

说明

Start-Process cmdlet 启动本地计算机上的一个或多个进程。 默认情况下，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.txt 文件。 UseNewEnvironment 参数指定该进程使用自己的环境变量运行。

$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 为 PowerShell 进程中运行的 powershell.exe 文件创建一个 System.Diagnostics.ProcessStartInfo 对象。 ProcessStartInfo 对象的谓词属性显示，可以将 Open 和 RunAs 谓词与 powershell.exe 或运行 .exe 文件的任何进程一起使用。

示例 7：指定进程的参数

这两个命令都启动 Windows 命令解释器，在 Program Files 文件夹中发出 dir 命令。 由于此文件夹名称包含空格，因此值需要用转义引号括起来。 请注意，第一个命令将字符串指定为 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 值，其中包含所有参数和所需的任何引号字符。

Type:	String[]
Aliases:	Args
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

指定有权执行此操作的用户帐户。 默认情况下，该 cmdlet 使用当前用户的凭据。

键入用户名，如 User01 或 Domain01\User01；或输入 Get-Credential cmdlet 生成的 PSCredential 对象。 如果键入用户名，系统会提示输入密码。

凭据存储在 PSCredential 对象中，密码存储为 SecureString。

注意

有关 SecureString 数据保护的详细信息，请参阅 SecureString 的安全性如何？。

Type:	PSCredential
Aliases:	RunAs
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

指定在进程中运行的程序的可选路径和文件名。 输入与计算机上的程序相关联的可执行文件或文档（如 .txt 或 .doc 文件）的名称。 此参数是必需的。

如果仅指定文件名，请使用 WorkingDirectory 参数指定路径。

Type:	String
Aliases:	PSPath
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadUserProfile

指示此 cmdlet 加载当前用户的 HKEY_USERS 注册表项中存储的 Windows 用户配置文件。

此参数不影响 PowerShell 配置文件。 有关详细信息，请参阅 about_Profiles。

Type:	SwitchParameter
Aliases:	Lup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoNewWindow

在当前控制台窗口中启动新进程。 默认情况下在 Windows 上，PowerShell 会打开一个新窗口。

不能在同一命令中使用 NoNewWindow 参数和 WindowStyle 参数。

Type:	SwitchParameter
Aliases:	nnw
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

为 cmdlet 启动的每个进程返回一个进程对象。 默认情况下，此 cmdlet 不会生成任何输出。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectStandardError

指定文件。 此 cmdlet 将进程产生的所有错误发送给指定的文件。 输入路径和文件名。 默认情况下，在控制台中显示这些错误。

Type:	String
Aliases:	RSE
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectStandardInput

指定文件。 此 cmdlet 从指定文件读取输入。 输入输入文件的路径和文件名。 默认情况下，进程从键盘获取其输入。

Type:	String
Aliases:	RSI
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RedirectStandardOutput

指定文件。 此 cmdlet 将进程产生的输出发送给指定的文件。 输入路径和文件名。 默认情况下，在控制台中显示该输出。

Type:	String
Aliases:	RSO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseNewEnvironment

指示此 cmdlet 使用为进程指定的新环境变量。 默认情况下，使用从父进程继承的环境变量运行启动的进程。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Verb

指定此 cmdlet 启动进程时要使用的动词。 可用的谓词取决于进程中运行的文件的文件扩展名。

下表列出了适用于某些常用进程文件类型的动词。

文件类型	动词
.cmd
.exe	.- .
.txt	.- .
.wav	%>

若要查找进程中运行的文件适用的谓词，请使用 New-Object cmdlet 来为该文件创建 System.Diagnostics.ProcessStartInfo 对象。 ProcessStartInfo 对象的 Verbs 属性中会显示可用动词。 有关详细信息，请参阅示例。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Wait

指示此 cmdlet 将等到指定进程及其后代完成后再接受其他输入。 此参数禁止显示命令提示符或在进程完成之前一直保留窗口。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowStyle

指定用于新进程的窗口的状态。 默认值为 Normal。 此参数的可接受值为：

• Normal
• Hidden
• Minimized
• Maximized

不能在同一命令中使用 WindowStyle 参数和 NoNewWindow 参数。

Type:	ProcessWindowStyle
Accepted values:	Normal, Hidden, Minimized, Maximized
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkingDirectory

指定新进程应启动的位置。 默认位置是正在启动的可执行文件或文档的位置。 不支持通配符。 路径不得包含将解释为通配符的字符。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

None

默认情况下，此 cmdlet 不返回任何输出。

Process

如果使用 PassThru 参数，则此 cmdlet 将返回进程对象。

备注

Windows PowerShell 包含 Start-Process 的以下别名：

• saps
• start

本机命令是操作系统中安装的可执行文件。 这些可执行文件可以从任何命令行 shell（如 PowerShell）运行。 通常，运行命令的方式与在 bash 或 cmd.exe 中完全相同。 Start-Process cmdlet 可用于运行任何本机命令，但仅当需要控制命令的执行方式时才应使用。

默认情况下，Start-Process以异步方式启动进程。 即使新进程仍在运行，控件也会立即返回到 PowerShell。

• 在本地系统上，启动的进程与调用过程无关。
• 在远程系统上，当远程会话结束时，新进程将立即在 Start-Process 命令后终止。 因此，不能在需要启动的进程超过会话的远程会话中使用 Start-Process。

如果需要在远程会话中使用 Start-Process，请使用 Wait 参数调用它。 或者，可以使用其他方法在远程系统上创建新进程。

使用 Wait 参数时，Start-Process 等待进程树（进程及其所有后代）在返回控件之前退出。 这不同于 Wait-Process cmdlet 的行为，该 cmdlet 仅等待指定的进程退出。

在 Windows 上，Start-Process 最常见的用例是使用 Wait 参数阻止进度，直到新进程退出。 在非 Windows 系统上，几乎很少需要这样做，因为命令行应用程序的默认行为等效于 Start-Process -Wait。

此 cmdlet 使用 System.Diagnostics.Process 类的 Start 方法来实施。 有关此方法的详细信息，请参阅 Process.Start 方法。

相关链接

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