Get-CsWindowsService

Skype for Business Server 2015
 

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

Командлет Get-CsWindowsService возвращает подробные сведения о компонентах Skype для бизнеса Server 2015, которые работают как службы Windows. Данный командлет впервые появился в Lync Server 2010.

Get-CsWindowsService [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Name <String>] [-Report <String>]

Команда, показанная в примере 1, возвращает сведения о всех службах Skype для бизнеса Server 2015, установленных на локальном компьютере. Для этого вызывается командлет Get-CsWindowsService без параметров.

Get-CsWindowsService

В примере 2 также возвращаются сведения о службах Skype для бизнеса Server 2015 на локальном компьютере. Однако в этом случае данные выводятся в форме списка. (Помимо прочего, это позволяет просматривать значения всех свойств для каждой службы. В табличном представлении, используемом по умолчанию, выводится только часть значений свойств.) Для этого сначала вызывается командлет Get-CsWindowsService , после чего полученные сведения передаются в командлет Format-List .

Get-CsWindowsService | Format-List

В примере 3 возвращаются сведения для отдельной службы Skype для бизнеса Server 2015 — службы с именем RTCSrv.

Get-CsWindowsService -Name "RTCSrv"

В примере 4 выводятся подробные сведения о всех ролях, выполняемых службой RTCSrv. Для этого сначала используется командлет Get-CsWindowsService , который возвращает сведения о службе RTCSrv. Затем эти сведения передаются в командлет Select-Object с параметром ExpandProperty, с помощью которого отображаются все роли, выполняемые службой RTCSrv. Обратите внимание на то, что если службе не назначено имя роли, эта команда вернет сообщение об ошибке.

Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName

Команда, показанная в примере 5, возвращает сведения о службах Skype для бизнеса Server 2015, установленных на удаленном компьютере atl-cs-001.litwareinc.com. Для этого используется параметр ComputerName, после которого указывается полное доменное имя удаленного компьютера.

Get-CsWindowsService -Computer atl-cs-001.litwareinc.com

В примере 6 возвращаются сведения о всех службах Skype для бизнеса Server 2015, установленных на локальном компьютере. Кроме того, используется параметр Report для сохранения сведений об ошибках в файл с именем C:\Logs\Services.html. Если при выполнении командлета Get-CsWindowsService возникнут проблемы с получением данных, сведения о них будут записаны в файл Services.html.

Get-CsWindowsService -Report C:\Logs\Services.html

В примере 7 возвращаются сведения только о тех службах Skype для бизнеса Server 2015, которые выполняются в настоящее время на локальном компьютере. Для этого команда сначала вызывает командлет Get-CsWindowsService , который возвращает коллекцию всех служб Skype для бизнеса Server 2015, как запущенных, так и не запущенных. Затем эта коллекция передается командлету Where-Object , который выбирает только те службы, свойство Status которых имеет значение Running.

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

В примере 8 показано, как извлечь сведения об определенной службе, даже если ее имя не известно (в данном случае это служба RTCASMCU). Для этого сначала вызывается командлет Get-CsWindowsService без параметров. Он возвращает коллекцию всех служб Skype для бизнеса Server 2015 на локальном компьютере. Эта коллекция затем передается в командлет Where-Object , который выбирает службу, значение свойства DisplayName которой включает (-like) строку "Application Sharing". В итоге выводятся сведения о службе Skype для бизнеса Server 2015 совместного доступа к приложениям в ходе конференций.

Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}

В примере 9 возвращаются сведения о всех службах, которым назначена роль сервера приложений. Для этого команда сначала вызывает командлет Get-CsWindowsService , который возвращает коллекцию всех служб Skype для бизнеса Server 2015 на локальном компьютере. Затем эта коллекция передается в командлет Where-Object , который выбирает службы, свойство RoleName которых включает (-contains) значение ApplicationServer.

Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}

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

Автоматическая фильтрация командлетом Get-CsWindowsService служб, не относящихся к Skype для бизнеса Server 2015, является одним из его преимуществ над командлетом Get-Service общего назначения, входящим в состав Windows PowerShell. Помимо этого, есть еще одна причина использовать командлет Get-CsWindowsService для извлечения сведений о службе Skype для бизнеса Server 2015: командлет Get-CsWindowsService возвращает полезные данные, которые нельзя получить с помощью командлета Get-Service . Например, при получении сведений о службе помощника по конференц-связи Skype для бизнеса Server 2015 командлет Get-CsWindowsService возвращает число звонков, одновременно обрабатываемых службой (уровень активности службы). Командлет Get-Service таких данных не возвращает.

По умолчанию командлет Get-CsWindowsService применяется к локальному компьютеру. Однако добавив параметр ComputerName, можно получить сведения о службах Skype для бизнеса Server 2015, выполняющихся на удаленном компьютере.

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

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

 

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

ComputerName

Нет

System.String

Имя удаленного компьютера, с которого необходимо получить сведения о службах. Если этот параметр не указан, командлет Get-CsWindowsService возвращает сведения о службах Skype для бизнеса Server 2015, запущенных на локальном компьютере. Для указания удаленного компьютера следует использовать полное доменное имя, например atl-mcs-001.litwareinc.com.

ExcludeActivityLevel

Нет

System.Management.Automation.SwitchParameter

Если этот параметр добавлен, командлет Get-CsWindowsService возвращает только состояние службы, но не уровень ее активности.

Name

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

System.String

Имя службы, для которой нужно вернуть сведения. Обратите внимание на то, что нужно использовать фактическое имя службы (например, RTCCAA), а не ее отображаемое имя. С помощью параметра Name можно передать командлету только одно имя службы, в котором нельзя использовать подстановочные символы.

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

Если этот параметр не указан, командлет Get-CsWindowsService возвращает сведения о всех службах Skype для бизнеса Server 2015.

Report

Нет

System.String

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

Нет. Командлет Get-CsWindowsService не принимает входные данные из конвейера.

Командлет Get-CsWindowsService возвращает экземпляры объекта Microsoft.Rtc.Management.Deployment.Core.NTService.

 
Показ: