Start-CsWindowsService
Tópico modificado em: 2012-03-27
Start-CsWindowsService permite iniciar um serviço do Microsoft Lync Server 2010.
Sintaxe
Start-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Start-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <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 um dos serviços do Lync Server estiver parado, ele poderá ser reiniciado, utilizando-se o cmdlet Start-CsWindowsService.
No entanto, observe que Start-CsWindowsService pode iniciar apenas os serviços do Lync Server. Ocorrerá um erro caso se tente iniciar com este cmdlet um serviço que não esteja associado ao Lync Server (como o spooler de impressão).
Funcionalmente, Start-CsWindowsService é muito semelhante ao cmdlet genérico do Windows PowerShellStart-Service. Se desejar, também é possível usar Start-Service para iniciar um serviço do Lync Server. Por outro lado, Start-CsWindowsService inclui um parâmetro (ComputerName), que torna fácil iniciar um serviço em um computador remoto: basta incluir o parâmetro ComputerName, seguido do nome do domínio totalmente qualificado do computador remoto. Stop-Service não possui um parâmetro comparável. Além disso, o parâmetro Report do cmdlet permite manter um registro de quaisquer erros que ocorrerem quando se chama Start-CsWindowsService.
Semelhantemente a outros serviços do Windows, alguns serviços do Lync Server possuem dependências de outros serviços. Por exemplo: o serviço de Atendedor de Conferência do Lync Server não poderá ser executado, a menos que o Serviço de aplicativos já estiver sendo executado. Caso se tente iniciar um serviço que dependa de outros, Start-CsWindowsService iniciará os demais serviços. Ou seja, caso se tente iniciar o serviço Atendedor de Conferência, o cmdlet iniciará primeiramente o Serviço de aplicativos e, em seguida, iniciará o serviço Atendedor de Conferência. Contudo, Start-CsWindowsService não iniciará automaticamente quaisquer serviços dependentes de um outro serviço: Caso se inicie o Serviço de aplicativos, este comando não iniciará automaticamente o serviço Atendedor de Conferência.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Start-CsWindows 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 "Start-CsWindowsService"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Name |
Opcional |
Cadeia de caracteres |
Nome do serviço do Lync Server que se deseja iniciar. 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. Os nomes do serviço podem ser recuperados usando-se o cmdlet Get-CsWindowsService. Lembre-se de que Start-CsWindowsService pode iniciar apenas serviços do Lync Server; não é possível usar esse cmdlet para iniciar outros serviços do Windows. No caso desses serviços, é possível utilizar o cmdlet do Windows PowerShell Start-Service. |
ComputerName |
Opcional |
Cadeia de caracteres |
Nome do computador remoto que hospeda o serviço a ser iniciado. Se este parâmetro não for incluído,Start-CsWindowsService iniciará o serviço (ou serviços) especificado no computador local. O computador remoto deve ser referenciado por seu FQDN. Por exemplo: atl-cs-001.litwareinc.com. |
InputObject |
Opcional |
Objeto NTService |
Permite iniciar 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 iniciar o serviço utilizando-se o seguinte comando: $x = Get-CsWindowsService -Name "RTCCPS" Start-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 armazenadas 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. Start-CsWindowsService aceita instâncias canalizadas do objeto de serviço do Windows.
Tipos de Retorno
Nenhuma. Em vez disso, Start-CsWindowsService inicia instâncias do objeto Microsoft.Rtc.Management.Deployment.Core.NTService.
Exemplo
-------------------------- Exemplo 1 ------------------------
Start-CsWindowsService
O comando mostrado no Exemplo 1 inicia todos os serviços do Lync Server no computador local. Isto é realizado chamando-se Start-CsWindowsService sem quaisquer parâmetros. Observe que não será emtido um erro quando se tenta iniciar um serviço que já tenha sido iniciado.
-------------------------- Exemplo 2 ------------------------
Start-CsWindowsService -Name "RTCRGS"
O comando anterior inicia o serviço do Aplicativo Grupo de Resposta no computador local. Para fazer isto, o comando utiliza o parâmetro Name, seguido do nome do serviço: RTCRGS.
-------------------------- Exemplo 3 ------------------------
Start-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
O comando mostrado no Exemplo 3 também inicia o serviço do Aplicativo Grupo de Resposta; neste caso, contudo, o serviço é iniciado no computador remoto atl-cs-001.litwareinc.com. Para iniciar um serviço em um computador remoto, inclua o parâmetro ComputerName, seguido do FQDN do computador remoto.
-------------------------- Exemplo 4 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -ne "Running"} | Start-CsWindowsService
No Exemplo 4, o comando pesquisa todos os serviços do Lync Server que estiverem no computador local e não estiverem sendo executados e, em seguida, inicia cada serviço inativo. Para fazer isto, o comando primeiramente chama Get-CsWindowsService, retornando um conjunto de todos os serviços do Lync Server. Este conjunto será então canalizado para o cmdlet Where-Object, que selecionará somente os serviços cuja propriedade Status for diferente de Running. Este conjunto será então canalizado para Start-CsWindowsService, que iniciará cada serviço na coleção.