Compartilhar via


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.

Consulte Também

Outros Recursos

Get-CsWindowsService
Stop-CsWindowsService