Set-Service

语法

Set-Service
   [-Name] <String>
   [-ComputerName <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 更改服务的属性，例如 状态、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 参数将服务设置为 自动。

Get-Service 使用 Name 参数指定 BITS 服务，并将对象发送到管道。 Select-Object 使用 属性 参数显示 BITS 服务的状态。

示例 3：更改服务的说明

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

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

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 参数使用 运行 的值来启动服务。 PassThru 参数输出显示结果的 ServiceController 对象。

示例 5：暂停服务

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

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

Get-Service 使用 Name 参数来指定 计划 服务，并将对象发送到管道。 Set-Service 使用 Status 参数将服务设置为 暂停。

示例 6：停止服务

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

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

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

参数

-ComputerName

-Confirm

-Description

-DisplayName

-InputObject

-Name

-PassThru

-StartupType

-Status

-WhatIf

输入

System.ServiceProcess.ServiceController, System.String

可以使用管道将服务对象或包含服务名称的字符串发送到 Set-Service。

输出

ServiceController

默认情况下，Set-Service 不返回任何对象。 使用 PassThru 参数输出 ServiceController 对象。

备注

Set-Service 需要提升的权限。 使用 以管理员身份运行 选项。

Set-Service 只能在当前用户有权管理服务时控制服务。 如果命令无法正常工作，则可能没有所需的权限。

若要查找服务的服务名称或显示名称，请使用 Get-Service。 服务名称位于 名称 列中，显示名称位于 DisplayName 列中。

相关链接

• Get-Service
• New-Service
• Restart-Service
• Resume-Service
• Start-Service
• Stop-Service
• Suspend-Service