Stop-CsWindowsService
Tópico modificado em: 2012-03-27
Stop-CsWindowsService permite interromper um serviço do Microsoft Lync Server 2010.
Sintaxe
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>]]
Descrição Detalhada
Muitos componentes do Lync Server 2010 são executados como serviços comuns do Windows. Por exemplo: na realidade, o Aplicativo Atendedor de Conferência é um serviço denominado RTCCAA. Se você precisar interromper um serviço do Lync Server, é possível fazê-lo usando o cmdlet Stop-CsWindowsService.
Lembre-se de que o Stop-CsWindowsService pode interromper apenas os serviços do Lync Server; ocorrerá um erro caso se tente interromper com este cmdlet um serviço que não esteja associado ao Lync Server (como o spooler de impressão).
Funcionalmente, Stop-CsWindowsService é muito semelhanto ao cmdlet genérico do Windows PowerShell (Stop-Service). Se desejar, também é possível usar Stop-Service para interromper um serviço do Lync Server. Contudo, Stop-CsWindowsService inclui um parâmetro ComputerName, que torna fácil interromper um serviço em um computador remoto: basta incluir o parâmetro ComputerName, seguido do nome do domínio totalmente qualificado do computador remoto. O cmdlet Stop-Service não possui um parâmetro comparável. Além disso, Stop-CsWindowsService possui um parâmetro Report, que permite manter um registro de quaisquer erros que possam ocorrer quando se chama Stop-CsWindowsService.
Stop-CsWindowsService faz exatamente o que o seu nome sugere: ele atende à sua solicitação de interrupção de qualquer serviço. Isso inclui serviços que possuem serviços dependentes (aqueles que podem ser executados apenas se o serviço que se tentou parar estiver em execução). Por padrão, caso se tente parar um serviço com serviços dependentes, Stop-CsWindowsService não apenas irá parar o serviço em questão, mas também todos os serviços dependentes. Como isto poderia gerar consequências inesperadas, pode-se incluir o parâmetro Graceful ao se chamar Stop-CsWindowsService. Quando você incluir o parâmetro Graceful, Stop-CsWindowsService impedirá que o serviço aceite novas solicitações. Todas as solicitações do serviço existentes permanecerão como estão; no entanto, as novas solicitações serão rejeitadas. Assim que as solicitações existentes acabarem, elas não serão substituídas. Eventualmente, todas as solicitações existentes serão atendidas e o serviço será desligado.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Stop-CsWindowsService localmente: RTCUniversalServerAdmins. Além disso, para poder executar esse cmdlet, é necessário possuir direitos de administrador local no computador de destino. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Stop-CsWindowsService"}
Parâmetros
| Parameter | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Name |
Opcional |
Cadeia de caracteres |
Nome do serviço do Lync Server que se deseja parar. Observe que é necessário usar o nome do serviço (por exemplo, RTCCAA), e não o nome de exibição do serviço. É possível passar apenas um único nome de serviço ao parâmetro Name e não é possível utilizar caracteres curinga no nome do serviço. É possível usar o cmdlet Get-CsWindowsService para recuperar nomes de serviço. Lembre-se de que Stop-CsWindowsService pode parar apenas serviços do Lync Server; não é possível usar esse cmdlet para parar outros serviços do Windows. No caso desses serviços, é possível utilizar o cmdlet do Windows PowerShell Stop-Service. |
ComputerName |
Opcional |
Cadeia de caracteres |
Nome do computador remoto que executa o serviço a ser interrompido. Se este parâmetro não for incluído, Stop-CsWindowsService irá parar o serviço especificado no computador local. O computador remoto deve ser referenciado por seu FQDN. Por exemplo: atl-mcs-001.litwareinc.com. |
Graceful |
Opcional |
Parâmetro de opção |
Em vez de encerrar imediatamente um serviço, ele aguardará até que todas as solicitações do serviço existentes tenham sido concluídas. (no entanto, todas as novas solicitações do serviço serão rejeitadas). O serviço não será encerrado completamente enquanto todas as solicitações existentes não tiverem sido concluídas. |
InputObject |
Opcional |
Objeto NTService |
Permite parar um serviço utilizando-se uma referência de objeto, em vez de um nome de serviço. Por exemplo, se Get-CsWindowsService for utilizado para retornar informações sobre um serviço e se o objeto retornado for armazenado em uma variável denominada $x, será possível interromper o serviço utilizando-se o seguinte comando: $x = Get-CsWindowsService –Name "RTCCPS" Stop-CsWindowsService -InputObject $x.Name |
NoWait |
Opcional |
Parâmetro de opção |
Quando presente, faz com que o comando seja executado e retorne imediatamente o controle ao prompt do Windows PowerShell. Se não estiver presente, o controle não será retornado enquanto o comando não tiver sido concluído e um relatório de status não tiver sido enviado para a tela. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
Report |
Opcional |
Cadeia de caracteres |
Caminho do arquivo HTML no qual poderão ser gravadas as informações de erro. Se este parâmetro for incluído, os erros que ocorrerem durante a execução deste cmdlet serão registrados no arquivo especificado (por exemplo: C:\Logs\Service_report.html). |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.Deployment.Core.NTService. Stop-CsWindowsService aceita instâncias canalizadas do objeto de serviço do Windows.
Tipos de Retorno
Nenhuma. Em vez disso, Stop-CsWindowsService interrompe instâncias do objeto Microsoft.Rtc.Management.Deployment.Core.NTService.
Exemplo
-------------------------- Exemplo 1 ------------------------
Stop-CsWindowsService -Name "RTCRGS"
O comando apresentado no Exemplo 1 interrompe o serviço Aplicativo Grupo de Resposta no computador local. O serviço Aplicativo Grupo de Resposta é identificado pela inclusão do parâmetro Name e do seu nome: RTCRGS.
-------------------------- Exemplo 2 ------------------------
Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
O Exemplo 2 também interrompe o serviço Aplicativo Grupo de Resposta. Neste exemplo, entretanto, este serviço está localizado no computador remoto atl-cs-001.litwareinc.com. Para interromper um serviço em um computador remoto, inclua o parâmetro ComputerName, seguido do FQDN do computador remoto.
-------------------------- Exemplo 3 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService
O Exemplo 3 demonstra como se pode parar um serviço, mesmo caso não se saiba o seu nome (neste exemplo, RTCCPS). Para fazer isso, o comando chama primeiramente Get-CsWindowsService, sem quaisquer parâmetros, retornando um conjunto de todos os serviços do Lync Server no computador local. O conjunto completo será então canalizado para o cmdlet Where-Object, que selecionará apenas os serviços cuja propriedade DisplayName incluir o valor da cadeia de caracteres "Call Park". O conjunto filtrado será canalizado para Stop-CsWindowsService, que irá interromper o serviço Aplicativo de Estacionamento de Chamada.