Start-Service

参考

模块:: Microsoft.PowerShell.Management

启动一个或多个已停止的服务。

语法

Start-Service
     [-InputObject] <ServiceController[]>
     [-PassThru]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-Service
     [-Name] <String[]>
     [-PassThru]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-Service
     [-PassThru]
     -DisplayName <String[]>
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

Start-Service cmdlet 将启动消息发送到每个指定服务的 Windows 服务控制器。如果服务已在运行，则会忽略该消息，而不会出错。可以按服务名称或显示名称指定服务，也可以使用 InputObject 参数来提供表示要启动的服务的服务对象。

示例

示例 1：使用服务名称启动服务

此示例在本地计算机上启动 EventLog 服务。 Name 参数按服务名称标识服务。

Start-Service -Name "eventlog"

示例 2：在不启动服务的情况下显示信息

此示例显示如果启动具有包含“remote”的显示名称的服务，会发生什么情况。

Start-Service -DisplayName *remote* -WhatIf

DisplayName 参数按服务显示名称而不是服务名称来标识服务。 WhatIf 参数会导致 cmdlet 显示运行命令但未进行更改时会发生的情况。

示例 3：启动服务并在文本文件中记录作

此示例在计算机上启动 Windows Management Instrumentation （WMI）服务，并将作记录添加到 services.txt 文件。

$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt

首先，我们使用 Get-Service 获取表示 WMI 服务的对象，并将其存储在 $s 变量中。接下来，启动服务。如果没有 PassThru 参数，Start-Service 不会创建任何输出。管道运算符（|）通过将对象输出 Start-Service 传递给 Format-List cmdlet，将对象格式化为其属性的列表。追加重定向运算符（>>）将输出重定向到 services.txt 文件。输出将添加到现有文件的末尾。

示例 4：启动已禁用的服务

此示例演示如何在服务的启动类型禁用时启动服务。

PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot
start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service  <<<< tlntsvr

PS> Get-CimInstance win32_service | Where-Object Name -eq "tlntsvr"
ExitCode  : 0
Name      : TlntSvr
ProcessId : 0
StartMode : Disabled
State     : Stopped
Status    : OK

PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr

第一次尝试启动 Telnet 服务（tlntsvr）失败。 Get-CimInstance 命令显示 Tlntsvr 服务的 StartMode 属性禁用。 Set-Service cmdlet 将开始类型更改为手动。现在，我们可以重新提交 Start-Service 命令。这一次，命令成功。若要验证命令是否成功，请运行 Get-Service。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

指定要启动的服务的显示名称。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	True

-Exclude

指定此 cmdlet 省略的服务。此参数的值限定 Name 参数。输入名称元素或模式，例如 s*。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Include

指定此 cmdlet 启动的服务。此参数的值限定 Name 参数。输入名称元素或模式，例如 s*。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-InputObject

指定 ServiceController 表示要启动的服务的对象。输入包含对象的变量，或键入获取对象的命令或表达式。

类型:	ServiceController[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定要启动的服务的服务名称。

参数名称是可选的。可以使用名称或其别名、ServiceName，也可以省略参数名称。

类型:	String[]
别名:	ServiceName
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PassThru

返回一个表示服务的对象。默认情况下，此 cmdlet 不生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

ServiceController

可以通过管道将服务对象传递给此 cmdlet。

String

可以通过管道将包含服务名称的字符串传递给此 cmdlet。

输出

None

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