Start-CsWindowsService

 

上一次修改主题: 2012-03-27

通过 Start-CsWindowsService 可以启动 Microsoft Lync Server 2010 服务。

语法

Start-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Start-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InputObject <NTService>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

详细说明

许多 Lync Server 2010 组件作为标准 Windows 服务运行,例如会议助理应用程序实际是名为 RTCCAA 的服务。如果某个 Lync Server 服务当前处于停止状态,可以使用 Start-CsWindowsService cmdlet 重新启动该服务。

但请注意,Start-CsWindowsService 只能启动 Lync Server 服务;如果您试图使用此 cmdlet 启动非 Lync Server 服务(如打印后台处理程序),则会发生错误。

从功能上讲,Start-CsWindowsService 非常类似于常规的 Windows PowerShell cmdlet Start-Service;如果需要,也可以使用 Start-Service 启动 Lync Server 服务。另一方面,Start-CsWindowsService 包括 ComputerName 参数,使得可轻松在远程计算机上启动服务:您只需包含 ComputerName 参数并后跟远程计算机的完全限定域名 (FQDN)。Stop-Service 不具有类似参数。此外,此 cmdlet 的 Report 参数可用于通过日志记录调用 Start-CsWindowsService 时可能会发生的任何错误。

与其他 Windows 服务类似,某些 Lync Server 服务依赖于其他服务;例如,除非应用程序服务已在运行,否则 Lync Server Conferencing Attendant 服务无法运行。如果您试图启动依赖于其他服务的服务,则 Start-CsWindowsService 将同时启动这两个服务。这意味着,如果您试图启动 Conferencing Attendant 服务,则该 cmdlet 将首先启动应用程序服务,然后再启动 Conferencing Attendant 服务。但是,Start-CsWindowsService 不会自动启动某个服务的任何相关服务:如果您启动应用程序服务,该命令不会同时自动启动 Conferencing Attendant 服务。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Start-CsWindows cmdlet:RTCUniversalServerAdmins。此外,您还必须拥有目标计算机的本地管理员权限才能运行此 cmdlet。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Start-CsWindowsService"}

参数

参数 必需 类型 描述

Name

可选

字符串

您希望启动的 Lync Server 服务的名称。请注意,必须使用服务名称(例如 RTCCAA)而非服务显示名称。只能将单个服务名称传递给 Name 参数,而且不能在服务名称中使用通配符。可以使用 Get-CsWindowsService cmdlet 检索服务名称。

请记住,Start-CsWindowsService 只能启动 Lync Server 服务;您不能使用此 cmdlet 启动其他 Windows 服务。对于这些服务,可以使用 Windows PowerShellStart-Service cmdlet 来启动。

ComputerName

可选

字符串

托管要启动的服务的远程计算机名称;如果未包括此参数,则 Start-CsWindowsService 将在本地计算机上启动指定的一个或多个服务。远程计算机应使用其 FQDN 进行引用;例如,atl-cs-001.litwareinc.com。

InputObject

可选

NTService 对象

使您可以使用对象引用而不是服务名称来启动服务。例如,如果使用 Get-CsWindowsService 返回有关某个服务的信息,并且您在名为 $x 的变量中存储返回的对象,则可以使用以下命令启动该服务:

$x = Get-CsWindowsService -Name "RTCCPS"

Start-CsWindowsService -InputObject $x.Name

NoWait

可选

开关参数

如果存在此参数,会导致运行命令,并将控制权立即返回至 Windows PowerShell 提示符。如果不存在此参数,则在命令完成并且状态报告已输出到屏幕上之后,才会返回控制权。

Force

可选

开关参数

禁止显示运行此命令时可能出现的任何非严重错误消息。

Report

可选

字符串

可以存储错误信息的 HTML 文件的路径。如果包括此参数,则在此 cmdlet 的运行期间发生的所有错误均将记录到指定的文件(例如,C:\Logs\Service_report.html)中。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

开关参数

在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.Deployment.Core.NTService 对象。Start-CsWindowsService 接受通过管道传递的 Windows 服务对象的实例。

返回类型

无。Start-CsWindowsService 会启动 Microsoft.Rtc.Management.Deployment.Core.NTService 对象的实例。

示例

-------------------------- 示例 1 --------------------------

Start-CsWindowsService

示例 1 中显示的命令启动本地计算机上的所有 Lync Server 服务。这是通过调用不带任何参数的 Start-CsWindowsService 实现的。请注意,如果您试图启动已经启动的服务,将不会收到错误。

-------------------------- 示例 2 --------------------------

Start-CsWindowsService -Name "RTCRGS"

上述命令在本地计算机上启动响应组应用程序服务。为执行此操作,该命令使用 Name 参数后跟服务名称:RTCRGS。

-------------------------- 示例 3 --------------------------

Start-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com

示例 3 中显示的命令也启动响应组应用程序服务;但在此示例中,该服务是在远程计算机 atl-cs-001.litwareinc.com 上启动的。要在远程计算机上启动服务,请使用 ComputerName 参数,并后跟远程计算机的 FQDN。

-------------------------- 示例 4 --------------------------

Get-CsWindowsService | Where-Object {$_.Status -ne "Running"} | Start-CsWindowsService

在示例 4 中,该命令在本地计算机上搜索当前未运行的所有 Lync Server 服务,然后启动其中每个非活动服务。为执行此操作,该命令首先调用 Get-CsWindowsService 以返回所有 Lync Server 服务的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会仅选择 Status 属性不等于 Running 的服务。接下来,将筛选出的集合通过管道传递到 Start-CsWindowsService,后者会启动集合中的每一个服务。

另请参阅

其他资源

Get-CsWindowsService
Stop-CsWindowsService