Set-Service

参考

模块:: Microsoft.PowerShell.Management

启动、停止和挂起服务并更改服务的属性。

语法

Set-Service
   [-ComputerName <String[]>]
   [-Name] <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-Service
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-InputObject <ServiceController>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-Service cmdlet 更改服务的属性，例如 Status、Description、DisplayName 和 StartupType。 Set-Service 可以启动、停止或暂停服务。若要标识服务，请输入其服务名称或提交服务对象。或者，将服务名称或服务对象沿着管道发送到 Set-Service。

示例

示例 1：更改显示名称

在此示例中，服务的显示名称已更改。若要查看原始显示名称，请使用 Get-Service。

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Service 使用 Name 参数来指定服务的名称 LanmanWorkstation。 DisplayName 参数指定新的显示名称 LanMan Workstation。

示例 2：更改服务的启动类型

此示例演示如何更改服务的启动类型。

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Service 使用 Name 参数指定服务的名称 BITS。 StartupType 参数将服务设置为 Automatic。

Get-Service 使用 Name 参数来指定 BITS 服务，并沿着管道发送对象。 Select-Object 使用 Property 参数显示 BITS 服务的状态。

示例 3：更改服务的说明

此示例更改 BITS 服务的说明并显示结果。

使用 Get-CimInstance cmdlet，因为它返回 Win32_Service 对象，该对象包含服务的说明。

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance 将对象沿着管道发送到 Format-List，并显示服务的名称和说明。出于比较目的，命令在更新说明之前和之后运行。

Set-Service 使用 Name 参数来指定 BITS 服务。 Description 参数指定服务说明的更新文本。

示例 4：启动服务

在此示例中，将启动服务。

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

Set-Service 使用 Name 参数来指定服务 WinRM。 Status 参数使用值 Running 来启动服务。 PassThru 参数输出显示结果的 ServiceController 对象。

示例 5：暂停服务

此示例使用管道暂停服务。

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Service 使用 Name 参数指定 Schedule 服务，并沿着管道发送对象。 Set-Service 使用 Status 参数将服务设置为 Paused。

示例 6：停止服务

此示例使用变量来停止服务。

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Service 使用 Name 参数来指定服务 Schedule。对象存储在变量 $S 中。 Set-Service 使用 InputObject 参数并指定存储 $S 的对象。 Status 参数将服务设置为 Stopped。

示例 7：设置多个服务的启动类型

Set-Service cmdlet 一次只接受一个服务名称。但是，可以通过管道将多个服务传递给 Set-Service，以更改多个服务的配置。

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

参数

-ComputerName

指定一台或多台计算机。对于远程计算机，键入 NETBIOS 名称、IP 地址或完全限定的域名。如果未指定 ComputerName 参数，命令会在本地计算机上运行。

此参数不依赖于 PowerShell 远程处理。即使计算机未配置为运行远程命令，也可以使用 ComputerName 参数。

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

-Confirm

提示你在运行 Set-Service 之前进行确认。

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

-Description

指定服务的新说明。

服务说明显示在“计算机管理”、“服务”中。 Description 不是 ServiceController 对象的属性Get-Service。若要查看服务说明，请使用 Get-CimInstance，其返回表示服务的 Win32_Service 对象。

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

-DisplayName

指定服务的新显示名称。

注意

通常， Set-Service 仅在 Windows 服务上运行，而不在驱动程序上运行。但是，如果指定驱动程序的名称， Set-Service 则可以以驱动程序为目标。

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

-InputObject

指定一个 ServiceController 对象来表示要更改的服务。输入包含对象的变量，或者键入获取对象的命令或表达式（如 Get-Service 命令）。可以使用管道将服务对象发送到 Set-Service。

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

-Name

指定要更改的服务的服务名称。不允许使用通配符。可以使用管道将服务名称发送到 Set-Service。

注意

通常， Set-Service 仅在 Windows 服务上运行，而不在驱动程序上运行。但是，如果指定驱动程序的名称， Set-Service 则可以以驱动程序为目标。

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

-PassThru

返回一个 ServiceController 对象来表示已更改的服务。默认情况下，Set-Service 不会生成任何输出。

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

-StartupType

设置服务的启动类型。此参数的可接受值为：

Automatic - 服务将由操作系统在系统启动时启动或在系统启动时已启动。如果自动启动的服务依赖于手动启动的服务，则手动启动的服务也会在系统启动时自动启动。
Disabled - 服务被禁用，不能由用户或应用程序启动。
Manual - 服务只能由用户（使用服务控制管理器）或应用程序手动启动。
Boot - 指示该服务是由系统加载程序启动的设备驱动程序。此值仅对设备驱动程序有效。
System - 指示该服务是由 'IOInitSystem()' 函数启动的设备驱动程序。此值仅对设备驱动程序有效。

默认值为 Automatic。

类型:	ServiceStartMode
别名:	StartMode, SM, ST
接受的值:	Boot, System, Automatic, Manual, Disabled
Position:	Named
默认值:	Automatic
必需:	False
接受管道输入:	False
接受通配符:	False

-Status

指定服务的状态。

此参数的可接受值如下所示：

Paused。挂起服务。
正在运行。启动服务。
已停止。 停止服务。

类型:	String
接受的值:	Paused, Running, Stopped
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 Set-Service 运行的情况下会发生什么。 cmdlet 未运行。

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

输入

ServiceController

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

String

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

输出

None

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