Get-CsWindowsService
Tópico modificado em: 2012-03-23
Get-CsWindowsService retorna informações detalhadas sobre componentes do Microsoft Lync Server 2010 que são executados como serviços do Windows.
Sintaxe
Get-CsWindowsService [-Name <String>] [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Report <String>]
Descrição Detalhada
Muitos componentes do Lync Server 2010 são executados como serviços comuns do Windows; por exemplo, o Aplicativo Atendedor de Conferência do Lync Server é na verdade um serviço chamado RTCCAA. O cmdlet Get-CsWindowsService permite recuperar informações detalhadas sobre esses serviços do Lync Server, e apenas sobre esses serviços. Isso acontece porque o cmdlet foi criado para ignorar qualquer serviço que não seja parte do Lync Server.
O fato do Get-CsWindowsService filtrar automaticamente serviços que não sejam do Lync Server é uma vantagem que esse cmdlet oferece sobre o cmdlet genérico Get-Service, que é parte do Windows PowerShell. Além disso, há outro motivo para se usar o Get-CsWindowsService caso seja necessário recuperar informações sobre um serviço do Lync Server: Get-CsWindowsService retorna dados úteis que Get-Service não retorna. Por exemplo, ao retornar informações sobre o serviço Atendedor de Conferência do Lync Server, o Get-CsWindowsService informa o número de chamadas simultâneas que estão sendo manipuladas pelo serviço (o nível de atividade de serviço). O Get-Service não faz isso.
Por padrão, Get-CsWindowsService é executado contra o computador local. Porém, incluindo o parâmetro ComputerName, podem ser retornadas informações sobre os serviços do Lync Server em execução em um computador remoto.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsWindowsService localmente: RTCUniversalServerAdmins. Além disso, você deve ser membro do grupo Usuários de Monitor de Desempenho no computador de destino para executar este cmdlet. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWindowsService"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Name |
Opcional |
Cadeia de caracteres |
Nome do serviço sobre o qual as informações serão retornadas. Observe que é preciso usar o nome do serviço (por exemplo, RTCCAA), e não o nome para exibição do serviço. Só é possível passar um único nome de serviço para o parâmetro Name; além disso, caracteres curinga não podem ser usados no nome do serviço. Observe que Get-CsWindowsService só pode retornar informações sobre serviços do Lync Server; este cmdlet não pode ser usado para retornar informações sobre outros serviços do Windows. Para esses serviços, talvez seja possível usar o cmdlet Get-Service do Windows PowerShell. Se esse parâmetro não for incluído, Get-CsWindowsService irá retornar informações sobre todos os serviços do seu Lync Server. |
ComputerName |
Opcional |
Cadeia de caracteres |
Nome do computador remoto cujas informações de serviços serão recuperadas; se o parâmetro não for incluído, Get-CsWindowsService retornará informações sobre os serviços do Lync Server em execução no computador local. O computador remoto deve ser referenciado por seu FQDN (nome de domínio totalmente qualificado); por exemplo, atl-mcs-001.litwareinc.com. |
ExcludeActivityLevel |
Opcional |
Parâmetros de opção |
Se for incluído, este parâmetro faz com que Get-CsWindowsService retorne apenas o status do serviço, e não o nível de atividade do serviço. |
Report |
Opcional |
Cadeia de caracteres |
Caminho para um arquivo HTML no qual as informações de erro podem ser armazenadas. Se este parâmetro for incluído, erros que ocorram durante a execução deste cmdlet serão registrados no arquivo especificado (por exemplo, C:\Logs\Service_report.html). |
Tipos de Entrada
Nenhuma. Get-CsWindowsService não aceita entrada em pipeline.
Tipos de Retorno
Get-CsWindowsService retorna instâncias do objeto Microsoft.Rtc.Management.Deployment.Core.NTService.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsWindowsService
O comando mostrado no Exemplo 1 retorna informações sobre todos os serviços do Lync Server instalados no computador local. Isso é feito chamando-se Get-CsWindowsService sem parâmetros.
-------------------------- Exemplo 2 ------------------------
Get-CsWindowsService | Format-List
O Exemplo 2 também retorna informações sobre os serviços do Lync Server no computador local; neste caso, porém, os dados são exibidos no formato de lista. (dentre outras coisas, isso permite exibir todos os valores de propriedade de cada serviço). Na exibição padrão, tabular, apenas um subconjunto de valores de propriedades é exibido). Para realizar a tarefa, Get-CsWindowsService é chamado primeiro, e as informações resultantes são canalizadas para o cmdlet Format-List.
-------------------------- Exemplo 3 ------------------------
Get-CsWindowsService -Name "RTCSrv"
O Exemplo 3 retorna informações sobre um único serviço do Lync Server: o serviço com o nome RTCSrv.
-------------------------- Exemplo 4 ------------------------
Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName
No Exemplo 4, são exibidas informações detalhadas sobre todas as funções de serviço manipuladas pelo serviço RTCSrv. Para realizar esta tarefa, Get-CsWindowsService é usado primeiro para retornar informações sobre o serviço RTCSrv. Essas informações são canalizadas para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para exibir todas as funções manipuladas pelo serviço RTCSrv. Observe que esse comando retornará uma mensagem de erro se um serviço não tive um nome de função.
-------------------------- Exemplo 5 ------------------------
Get-CsWindowsService -Computer atl-cs-001.litwareinc.com
O comando mostrado no Exemplo 5 retorna informações sobre todos os serviços do Lync Server instalados no computador remoto atl-cs-001.litwareinc.com. Para isso, o parâmetro ComputerName é incluído, seguido pelo FQDN do computador remoto.
-------------------------- Exemplo 6 ------------------------
Get-CsWindowsService -Report C:\Logs\Services.html
O comando anterior retorna informações sobre todos os serviços do Lync Server instalados no computador local. Além disso, o parâmetro Report é incluído para salvar informações de erro em um arquivo chamado C:\Logs\Services.html. Se Get-CsWindowsService encontrar algum problema ao recuperar dados de serviços, informações sobre esse problema serão registradas no arquivo Services.html.
-------------------------- Exemplo 7 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -eq "Running"}
No Exemplo 7, são retornadas informações apenas sobre os serviços do Lync Server em execução no momento no computador local. Para fazer isso, o comando primeiro chama Get-CsWindowsService para retornar uma coleção de todos os serviços do Lync Server, em execução ou não. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas os serviços nos quais a propriedade Status seja igual a Running (em execução).
-------------------------- Exemplo 8 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}
O Exemplo 8 mostra como recuperar informações sobre um serviço específico mesmo sem saber o nome do serviço (no caso, RTCASMCU). Para realizar esta tarefa, Get-CsWindowsService é chamado primeiro sem parâmetros; isso retorna uma coleção de todos os serviços do Lync Server no computador local. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas o serviço no qual a propriedade DisplayName inclua (-like) o valor de cadeia de caracteres "Application Sharing" (compartilhamento de aplicativos). O resultado final: são exibidas informações sobre o Serviço de Conferência para Compartilhamento de Aplicativos do Lync Server.
-------------------------- Exemplo 9 ------------------------
Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}
O Exemplo 9 retorna informações sobre serviços que hospedem a função de Servidor de Aplicativos. Para fazer isso, o comando primeiro chama Get-CsWindowsService para retornar uma coleção de todos os serviços do Lync Server no computador local. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona os serviços nos quais a propriedade RoleName inclua (-contains) ApplicationServer.