Stop-CsWindowsService
上一次修改主题： 2012-03-27
通过 Stop-CsWindowsService 可以停止 Microsoft Lync Server 2010 服务。
语法
Stop-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Stop-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-InputObject <NTService>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
详细说明
许多 Lync Server 2010 组件作为标准 Windows 服务运行，例如会议助理应用程序实际是名为 RTCCAA 的服务。如果需要停止 Lync Server 服务，可以使用 Stop-CsWindowsService cmdlet 完成。
请记住，Stop-CsWindowsService 只能停止 Lync Server 服务；如果您试图使用此 cmdlet 停止非 Lync Server 服务（如打印后台处理程序），则会发生错误。
从功能上讲，Stop-CsWindowsService 非常类似于常规的 Windows PowerShell cmdlet Stop-Service；如果需要，可以使用 Stop-Service 停止 Lync Server 服务。但是，Stop-CsWindowsService 包括 ComputerName 参数，使得可轻松在远程计算机上停止服务。您只需包含 ComputerName 参数并后跟远程计算机的完全限定域名 (FQDN)。Stop-Service cmdlet 不具有类似参数。此外，Stop-CsWindowsService 还具有一个 Report 参数，使用此参数可记录在调用 Stop-CsWindowsService 时可能会发生的任何错误。
Stop-CsWindowsService 执行与名称所指完全一样的操作：它会停止您要求停止的任何服务。这其中包括具有相关服务的服务（只有您试图停止的服务正在运行时才能运行的服务）。默认情况下，如果您尝试停止具有相关服务的服务，Stop-CsWindowsService 将不仅会停止所指服务，还会停止其所有相关服务。由于这可能会造成意外后果，因此在调用 Stop-CsWindowsService 时可以包括 Graceful 参数。包含 Graceful 参数时，Stop-CsWindowsService 将阻止服务接受任何新的请求。所有现有的服务请求将保持不变，但是新请求将被拒绝。处理完现有请求后，将不再替换这些请求。最终将填满所有现有请求，之后服务将关闭。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Stop-CsWindowsService cmdlet：RTCUniversalServerAdmins。此外，您还必须拥有目标计算机的本地管理员权限才能运行此 cmdlet。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Stop-CsWindowsService"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Name |
可选 |
字符串 |
您希望停止的 Lync Server 服务的名称。请注意，必须使用服务名称（例如 RTCCAA）而非服务显示名称。只能将单个服务名称传递给 Name 参数，而且不能在服务名称中使用通配符。可使用 Get-CsWindowsService cmdlet 检索服务名称。 请记住，Stop-CsWindowsService 只能停止 Lync Server 服务，不能使用此 cmdlet 停止其他 Windows 服务。对于这些服务，可以使用 Windows PowerShellStop-Service cmdlet 来停止。 |
ComputerName |
可选 |
字符串 |
运行要停止的服务的远程计算机名称；如果未包含此参数，则 Stop-CsWindowsService 将在本地计算机上停止指定的服务。远程计算机应使用其 FQDN 进行引用；例如 atl-mcs-001.litwareinc.com。 |
Graceful |
可选 |
开关参数 |
不是立即关闭服务，而是等到填满所有现有服务请求后再关闭。（但是，会拒绝所有新服务请求。）在填满所有现有的请求之前，该服务不会完全关闭。 |
InputObject |
可选 |
NTService 对象 |
使您可以使用对象引用而不是服务名称来停止服务。例如，如果使用 Get-CsWindowsService 返回有关某个服务的信息，并且您在名为 $x 的变量中存储返回的对象，则可以使用以下命令停止该服务： $x = Get-CsWindowsService –Name "RTCCPS" Stop-CsWindowsService -InputObject $x.Name |
NoWait |
可选 |
开关参数 |
如果存在此参数，会导致运行命令，并将控制权立即返回至 Windows PowerShell 提示符。如果不存在此参数，则在命令完成并且状态报告已输出到屏幕上之后，才会返回控制权。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
Report |
可选 |
字符串 |
可以写入错误信息的 HTML 文件的路径。如果包括此参数，则在此 cmdlet 的运行期间发生的所有错误均将记录到指定的文件（例如，C:\Logs\Service_report.html）中。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Deployment.Core.NTService 对象。Stop-CsWindowsService 接受通过管道传递的 Windows 服务对象的实例。
返回类型
无。Stop-CsWindowsService 会停止 Microsoft.Rtc.Management.Deployment.Core.NTService 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Stop-CsWindowsService -Name "RTCRGS"
示例 1 中显示的命令停止本地计算机上的响应组应用程序服务。响应组应用程序服务通过包含 Name 参数和该服务的名称 RTCRGS 来标识。
-------------------------- 示例 2 --------------------------
Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
示例 2 也停止响应组应用程序服务；但在此示例中，该服务位于远程计算机 atl-cs-001.litwareinc.com 上。要停止远程计算机上的服务，需要包含 ComputerName 参数，并后跟远程计算机的 FQDN。
-------------------------- 示例 3 --------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService
示例 3 演示如何在不知道服务名称（此示例中为 RTCCPS）的情况下停止服务。为执行此操作，该命令首先调用不带任何参数的 Get-CsWindowsService，以返回本地计算机上所有 Lync Server 服务的集合。然后，将整个集合通过管道传递到 Where-Object cmdlet，后者会仅选择 DisplayName 属性包括字符串值“Call Park”的服务。接下来，将筛选出的集合通过管道传递到 Stop-CsWindowsService，后者会停止呼叫寄存应用程序服务。