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。

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

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

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

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

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 服务的状态。

此示例更改 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 参数指定服务说明的更新文本。

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

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 对象。

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

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

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

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

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

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

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

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

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

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

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

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

使用 PassThru 参数时，此 cmdlet 将返回 ServiceController 对象。

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

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

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