Compartilhar via

  • Artigo

Remove-CsServerApplication

 

Tópico modificado em: 2012-03-27

Remove um aplicativo para servidores existente. Os aplicativos para servidores são hospedados pelo Microsoft Lync Server 2010.

Sintaxe

Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Os aplicativos do servidor se referem aos programas que são executados no Lync Server 2010. O cmdlet Remove-CsServerApplication permite aos administradores remover qualquer aplicativo que estiver sendo executado como parte do Lync Server. Observe que a exclusão de um aplicativo para servidores não é a mesma coisa que a desinstalação desse aplicativo. Ao se executar Remove-CsServerApplication, o aplicativo deixa de ser executado no Lync Server. Entretanto, o software não será desinstalado e o aplicativo pode ser reabilitado ao se executar o cmdlet New-CsServerApplication.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsServerApplication localmente: RTCUniversalServerAdmins. 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 "Remove-CsServerApplication }

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo do aplicativo para servidores a ser removido. As identidades dos aplicativos para servidores são compostas pelo serviço onde está hospedado o aplicativo mais o seu nome. Por exemplo, o aplicativo para servidores denominado QoEAgent pode ter uma identidade semelhante a esta: service:Registrar:atl-cs-001.litwareinc.com/QoEAgent.

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.

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.WritableConfig.Settings.ServerApplication.Application. Remove-CsServerApplication aceita instâncias canalizadas do objeto de aplicativo de servidor.

Tipos de Retorno

Remove-CsServerApplication exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Exemplo

-------------------------- Exemplo 1 ------------------------

Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"

No Exemplo 1, o aplicativo de servidor que possui a Identidade service: EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor será removido. Como as identidades devem ser exclusivas, este comando nunca excluirá mais do que um único aplicativo.

-------------------------- Exemplo 2 ------------------------

Get-CsServerApplication | Where-Object {$_.Critical -eq $False} | Remove-CsServerApplication

No Exemplo 2, serão removidos todos os aplicativos não-críticos para servidores. Para realizar essa tarefa, o comando chama primeiramente Get-CsServerApplication, retornando uma coleção de todos os aplicativos para servidores em uso na organização. Esta coleção será canalizada para Where-Object, que selecionará todos os aplicativos cuja propriedade Critical for igual a False. Esta coleção filtrada será então canalizada para Remove-CsServerApplication, que excluirá cada item da coleção.

-------------------------- Exemplo 3 ------------------------

Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication

O comando anterior exclui todos os aplicativos para servidores que tiverem sido configurados para uso pelo serviço EdgeServer:atl-cs-001.litwareinc.com. Para fazer isso, Get-CsServerApplication é utilizado juntamente com o parâmetro Filter. O valor de filtro "service:EdgeServer:atl-cs-001.litwareinc.com/*" retorna todos os aplicativos cuja identidade for iniciada pelos caracteres "service:EdgeServer:atl-cs-001.litwareinc.com/". Por sua vez, essa coleção será canalizada para Remove-CsServerApplication, que excluirá cada aplicativo de EdgeServer:atl-cs-001.litwareinc.com.