Stop-CsWindowsService

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Stop-CsWindowsService используется для останова службы Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

Stop-CsWindowsService [-ComputerName <String>] [-Name <String>] <COMMON PARAMETERS>
Stop-CsWindowsService [-InputObject <NTService>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-LeaveClsAgentRunning <SwitchParameter>] [-LeaveWebServerRunning <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Команда, рассматриваемая в примере 1, служит для останова службы "Группа ответа" на локальном компьютере. Идентификация службы "Группа ответа" выполняется путем добавления параметра Name и имени этой службы: RTCRGS.

Stop-CsWindowsService -Name "RTCRGS"

В примере 2 также рассматривается останов службы "Группа ответа". В этом примере, однако, данная служба размещается на удаленном компьютере atl-cs-001.litwareinc.com. Чтобы остановить службу на удаленном компьютере, необходимо добавить параметр ComputerName, после которого указывается полное доменное имя удаленного компьютера.

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

В примере 3 показано, как можно остановить службу даже в том случае, когда имя службы неизвестно (например, RTCCPS). Для этого команда сначала вызывает командлет Get-CsWindowsService без параметров, чтобы получить коллекцию всех служб Skype для бизнеса Server 2015 на локальном компьютере. Затем эта полная коллекция передается в командлет Where-Object , который выбирает только те службы, в которых свойство DisplayName содержит строковое значение "Call Park". После фильтрации коллекция передается в командлет Stop-CsWindowsService , который останавливает службу приложения приостановки вызовов.

Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService

Многие компоненты Skype для бизнеса Server 2015 работают как стандартные службы Windows - например, компонент помощника по конференц-связи по сути является службой с именем RTCCAA. Чтобы остановить службу Skype для бизнеса Server 2015, можно использовать командлет Stop-CsWindowsService .

Необходимо учитывать, что командлет Stop-CsWindowsService может останавливать только службы Skype для бизнеса Server 2015, а при попытке выполнить с помощью этого командлета остановку службы, не относящейся к Skype для бизнеса Server 2015 (такой как диспетчер печати), возникает ошибка.

Функционально командлет Stop-CsWindowsService очень схож с общим командлетом Windows PowerShell Stop- Service. При желании также можно использовать командлет Stop-Service для остановки службы Skype для бизнеса Server 2015. Однако Stop-CsWindowsService содержит параметр ComputerName, с помощью которого можно легко остановить службу на удаленном компьютере — просто добавьте параметр ComputerName и после него укажите полное доменное имя (FQDN) удаленного компьютера. Командлет Stop-Service не содержит подобного параметра. Кроме того, Stop-CsWindowsService содержит параметр Report, который позволяет сохранить журнал всех ошибок, возникающих при вызове.

Командлет Stop-CsWindowsService выполняет как раз те функции, которые указаны в его названии — он останавливает все выбранные для остановки службы. К ним относятся и службы, содержащие зависимые службы (выполнение которых зависит от работы службы, которую вы пытаетесь остановить). По умолчанию в тех случаях, когда вы пытаетесь остановить службу, содержащую зависимые службы, командлет Stop-CsWindowsService останавливает не только указанную службу, но и все те службы, которые от нее зависят. Поскольку это может привести к непредвиденным последствиям, при вызове командлета Stop-CsWindowsService можно включить параметр Graceful. При добавлении параметра Graceful командлет Stop-CsWindowsService блокирует прием всех новых запросов данной службой. Существующих запросов это не касается, однако новые запросы будут отклоняться. После завершения обработки текущих запросов они не заменяются новыми. Постепенно обработка всех существующих запросов будет завершена, после чего служба будет остановлена.

По умолчанию командлет Stop-CsWindowsService могут запускать локально члены следующих групп: RTCUniversalServerAdmins. Кроме того, для запуска этого командлета вам потребуются права локального администратора на конечном компьютере. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все настраиваемые роли RBAC, созданные вами), запустите следующую команду Windows PowerShell:

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

 

Параметр Обязательный? Тип Описание

ComputerName

Необязательный

System.String

Имя удаленного компьютера, где работает служба, которую нужно остановить. Если этот параметр не задан, то командлет Stop-CsWindowsService остановит указанную службу на локальном компьютере. При ссылке на удаленный компьютер указывается его полное доменное имя, например atl-mcs-001.litwareinc.com.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Force

Необязательный

System.Management.Automation.SwitchParameter

Запрещает отображение всех сообщений о некритических ошибках на время выполнения команды.

Graceful

Необязательный

System.Management.Automation.SwitchParameter

Вместо того чтобы немедленно остановить службу, дожидается завершения обработки всех существующих запросов (однако при этом все новые запросы к службе будут отклонены). Служба будет полностью остановлена только после завершения обработки всех существующих запросов.

InputObject

Необязательный

Microsoft.Rtc.Management.Deployment.Core.NTService

Позволяет остановить службу, используя ссылку на объект вместо имени службы. Например, если для возврата данных о службе используется командлет Get-CsWindowsService , и возвращаемый объект сохраняется в переменной с именем $x, можно остановить службу с помощью следующей команды:

$x = Get-CsWindowsService –Name "RTCCPS"

Stop-CsWindowsService -InputObject $x.Name

LeaveClsAgentRunning

Необязательный

System.Management.Automation.SwitchParameter

Если указан, останавливает все службы Skype для бизнеса Server 2015, кроме службы агента централизованного ведения журнала.

LeaveWebServerRunning

Необязательный

System.Management.Automation.SwitchParameter

Данный параметр завершает работу всех служб на указанном компьютере, за исключением службы веб-служб.

Name

Необязательный

System.String

Имя службы Skype для бизнеса Server 2015, которую требуется остановить. Обратите внимание, что необходимо использовать имя службы (например, RTCCAA), а не отображаемое имя. В параметр Name можно передать только одно имя службы; использование подстановочных знаков в имени службы не допускается. Можно использовать командлет Get-CsWindowsService для получения имен служб.

Следует учитывать, что командлет Stop-CsWindowsService может останавливать только службы Skype для бизнеса Server 2015. Этот командлет нельзя использовать для остановки других служб Windows. Для них можно использовать командлет Windows PowerShell  Stop-Service .

NoWait

Необязательный

System.Management.Automation.SwitchParameter

Если этот параметр указан, команда запускается и затем сразу передает управление командной строке Windows PowerShell. В противном случае управление не будет передано до тех пор, пока команда не будет завершена и на экран не будет выведен отчет о состоянии.

Report

Необязательный

System.String

Путь к файлу HTML, в который выполняется запись данных об ошибке. Если этот параметр добавлен, все ошибки, возникающие во время выполнения этого командлета, регистрируются в указанном файле журнала (например, C:\Logs\Service_report.html).

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Объект Microsoft.Rtc.Management.Deployment.Core.NTService. Командлет Stop-CsWindowsService принимает конвейерные экземпляры объекта службы Windows.

Нет. Вместо этого командлет Stop-CsWindowsService останавливает экземпляры объекта Microsoft.Rtc.Management.Deployment.Core.NTService.

 
Показ: