当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] Restart-Service (Microsoft.PowerShell.Management)

作者:精品下载站 日期:2024-12-14 02:11:00 浏览:15 分类:玩电脑

Restart-Service (Microsoft.PowerShell.Management)


Restart-Service

模块 :Microsoft.PowerShell.Management

停止然后启动一项或多项服务。

句法

Restart-Service
       [-Force]
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restart-Service
       [-Force]
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restart-Service
       [-Force]
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

Restart-Service cmdlet 向指定服务的 Windows 服务控制器发送一条停止消息,然后发送一条启动消息。如果服务已停止,则会启动该服务而不通知您错误。您可以通过服务名称或显示名称来指定服务,也可以使用 InputObject 参数传递一个代表您要重新启动的每个服务的对象。

示例

示例 1:在本地计算机上重新启动服务

PS C:\> Restart-Service -Name winmgmt

此命令将重新启动本地计算机上的 Windows Management Instrumentation 服务 (WinMgmt)。

示例 2:排除服务

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

此命令将重新启动显示名称以 Net 开头的服务(Net Logon 服务除外)。

示例 3:启动所有已停止的网络服务

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

此命令启动计算机上所有已停止的网络服务。

此命令使用 Get-Service cmdlet 来获取表示服务名称以 net 开头的服务的对象。管道运算符 (|) 将服务对象发送到 Where-Object cmdlet,该 cmdlet 仅选择状态为已停止的服务。另一个管道操作员将选定的服务发送到Restart-Service。

实际上,您可以在运行命令之前使用 WhatIf 参数来确定命令的效果。

参数

-Confirm

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

类型 :

SwitchParameter

别名:

cf

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-DisplayName

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

类型 :

String[]

位置:

命名

默认值:

None

必需的:

True

接受管道输入:

False

接受通配符:

True

-Exclude

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

类型 :

String[]

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-Force

强制运行命令而不要求用户确认。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Include

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

类型 :

String[]

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-InputObject

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

类型 :

服务控制器[]

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-Name

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

类型 :

String[]

别名:

ServiceName

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

True

-PassThru

返回代表服务的对象。默认情况下,此 cmdlet 不生成任何输出。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-WhatIf

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

类型 :

SwitchParameter

别名:

wi

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

服务控制器

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

字符串

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

输出

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

服务控制器

当您使用 PassThru 参数时,此 cmdlet 将返回一个表示重新启动的服务的 ServiceController 对象。

笔记

此 cmdlet 仅在 Windows 平台上可用。

  • Restart-Service 仅当当前用户有权限时才能控制服务。如果命令无法正常工作,您可能没有所需的权限。
  • 要查找系统上服务的服务名称和显示名称,请键入 Get-Service"。服务名称显示在 名称 列中,显示名称显示在显示名称列。

您需要 登录账户 后才能发表评论

取消回复欢迎 发表评论:

关灯