Compartilhar via

  • Artigo

Get-CsServerApplication

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os aplicativos para servidores em uso na organização. Os aplicativos para servidores são hospedados pelo Microsoft Lync Server 2010.

Sintaxe

Get-CsServerApplication [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsServerApplication [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Os aplicativos do servidor se referem aos programas que são executados no Lync Server 2010. O cmdlet Get-CsServerApplication fornece aos administradores uma forma de retornar informações sobre quaisquer (ou todos) aplicativos que estiverem sendo executados como parte do Lync Server.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo do aplicativo para servidores a ser recuperado. 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: serviço: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Para recuperar uma coleção de todos os aplicativos que estiverem sendo executados em um determinado serviço, simplesmente deixe em branco o nome do aplicativo:

-Identity "Registrar:atl-cs-001.litwareinc.com "

Se esse parâmetro for omitido, todos os aplicativos para servidores serão retornados quando se chama Get-CsServerApplication.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao retornar um aplicativo ou conjunto de aplicativos para servidores. Por exemplo, para retornar todos os aplicativos para servidores com o valor da cadeia de caracteres "IIMFilter" em algum lugar de sua identidade, use essa sintaxe: -Filter "*IIMFilter*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados do aplicativo de servidor da réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsServerApplication não aceita a entrada canalizada.

Tipos de Retorno

Get-CsServerApplication retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Exemplo

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

Get-CsServerApplication

O comando exibido no Exemplo 1 retorna informações sobre todos os aplicativos para servidores em uso na organização. Isto é feito chamando-se Get-CsServerApplication sem nenhum parâmetro.

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

Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"

No Exemplo 2, são retornadas as informações relativas a todos os aplicativos para servidores que estiverem sendo executados no serviço EdgeServer:atl-edge-001.litwareinc.com.

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

Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"

O Exemplo 3 retorna informações relativas a um único aplicativo para servidores: o aplicativo com a identidade Registrar:atl-cs-001.litwareinc.com/ExumRouting".

-------------------------- Exemplo 4 ------------------------

Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"

O comando anterior retorna todos os aplicativos para servidores que tiverem sido configurados para uso no pool atl-cs-001.litwareinc.com. Isto é feito utilizando-se o parâmetro Filter e o valor de filtro "service:*:atl-cs-001.litwareinc.com*". O valor de filtro limita os dados retornados aos aplicativos que tiverem a identidade iniciada pelos caracteres "service:" e incluirem os caracteres ":atl-cs-001.litwareinc.com".

-------------------------- Exemplo 5 ------------------------

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

No Exemplo 5, são retornadas as informações relativas a todos os aplicativos para servidores que estiverem desabilitados. Para realizar essa tarefa, o comando chama primeiramente Get-CsServerApplication, para retornar uma coleção de todos os aplicativos para servidores em uso pela organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os aplicativos em que a propriedade Enable for igual a False.

-------------------------- Exemplo 6 ------------------------

Get-CsServerApplication | Where-Object {$_.Critical -eq $True -and $_.Enabled -eq $False}

O Exemplo 6 é uma variação do comando apresentado no Exemplo 5. No Exemplo 6, são retornadas as informações relativas a todos os aplicativos para servidores que estiverem desabilitados e marcados como críticos. Para fazer isso, o comando chama primeiramente Get-CsServerApplication sem quaisquer parâmetros. Isto retorna uma coleção de todos os aplicativos para servidores configurados para uso. Esta coleção será então canalizada para Where-Object, que selecionará apenas os aplicativos que atenderem a dois critérios: a propriedade Critical deve ser igual a True e a propriedade Enabled deve ser igual a False. O operador -and garante que apenas objetos que atenderem a ambos os critérios serão retornados.

-------------------------- Exemplo 7 ------------------------

Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}

No Exemplo 7, são retornadas as informações relativas a qualquer aplicativo para servidores que tiver o valor da cadeia de caracteres "routing" em alguma posição de seu Uri. Esta tarefa é realizada utilizando-se primeiramente Get-CsServerApplication, para recuperar todos os aplicativos para servidores em uso. A coleção resultante será então canalizada para Where-Object, que selecionará apenas os aplicativos cuja propriedade Uri incluir o valor da cadeia de caracteres "routing".

-------------------------- Exemplo 8 ------------------------

Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}

O comando anterior retornará informações relativas a todos os aplicativos para servidores aos quais tiver sido atribuído um script. Para fazer isso, o comando primeiramente recupera uma coleção de todos os aplicativos para servidores em uso; estas informações são recuperadas chamando-se Get-CsServerApplication sem quaisquer parâmetros. A coleção completa de aplicativos para servidores será então canalizada para o cmdlet Where-Object, que selecionará apenas os aplicativos nos quais a propriedade ScriptName não for igual a um valor null. Se a propriedade ScriptName não for igual a um valor null, isso significa que um script foi atribuído ao aplicativo.