Compartilhar via

  • Artigo

Set-CsServerApplication

 

Tópico modificado em: 2012-03-26

Modifica os valores da propriedade de um aplicativo de servidor existente. Os aplicativos para servidores são hospedados pelo Microsoft Lync Server 2010.

Sintaxe

Set-CsServerApplication [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsServerApplication [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Os aplicativos do servidor se referem aos programas que são executados no Lync Server 2010. O cmdlet Set-CsServerApplication permite aos administradores modificar os valores de propriedade de qualquer aplicativo que estiver sendo executado como parte do Lync Server.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsServerApplication localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsServerApplication"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

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

Instance

Opcional

Objeto ServerApplication.Application

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

Critical

Opcional

Booleano

Se for definido como True (o valor padrão), Lync Server não será iniciado, a menos que o aplicativo em questão possa ser iniciado. Se for Falso, o Lync Server será iniciado independentemente de o aplicativo poder ser iniciado ou não.

Enabled

Opcional

Booleano

Defina este valor como Verdadeiro, para habilitar o aplicativo. Defina este valor como Falso, para desabilitar o aplicativo.

Priority

Opcional

Inteiro

Indica a ordem de execução dos aplicativos para servidores. O aplicativo com prioridade 0 é iniciado primeiramente; o aplicativo com prioridade 1 é iniciado depois e assim por diante. Observe que cada serviço que hospeda um aplicativo para servidores possui o seu próprio conjunto exclusivo de prioridades. Por exemplo: o serviço Registrador deve hospedar três aplicativos com prioridades correspondentes 0, 1 e 2. Da mesma maneira, o serviço Servidor de Borda deve ter quatro aplicativos, cujas prioridades serão 0, 1, 2 e 3.

Se você não especificar uma prioridade, o aplicativo será adicionado automaticamente ao fim da lista de prioridades. Se você adicionar ou remover um aplicativo, as prioridades de outros aplicativos serão ajustadas de acordo. Por exemplo: se você excluir um aplicativo que possui a prioridade 0, o aplicativo cuja prioridade anterior era 1 será ajustado para a prioridade 0.

ScriptName

Opcional

Cadeia de caracteres

Caminho para o script da Linguagem de Processamento de SIP da Microsoft (MSPL) usado pelo aplicativo. MSPL é uma linguagem de script usada para filtrar e rotear mensagens SIP.

Uri

Opcional

Cadeia de caracteres

O Identificador de Recurso Uniforme (URI) exclusivo do aplicativo. Por exemplo, o aplicativo QoEAgent possui o URI https://www.microsoft.com/LCS/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.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da 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.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Set-CsServerApplication aceita instâncias canalizadas do objeto de aplicativo de servidor.

Tipos de Retorno

Set-CsServerApplication não retorna um valor ou objeto. Em vez disto, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application.

Exemplo

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

Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True

O comando exibido no Exemplo 1 habilitará o aplicativo para servidores cuja Identidade for Registrar:atl-cs-001.litwareinc.com/ExumRouting. Como as Identidades são exclusivas, este comando habilitará apenas um aplicativo para servidores.

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

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

O comando anterior habilitará todos os aplicativos para servidores que estiverem desabilitados. Para fazer isso, o comando chama primeiramente Get-CsServerApplication, para retornar uma coleção de todos os aplicativos para servidores em uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os aplicativos cuja propriedade Enable for igual a False. A seguir, a coleção filtrada será canalizada para Set-CsServerApplication, que selecionará cada item na coleção e definirá a propriedade Enabled como True.