Compartilhar via

  • Artigo

New-CsServerApplication

 

Tópico modificado em: 2012-03-26

Cria um novo aplicativo para servidores. Aplicativos para servidores são aplicativos hospedados pelo Microsoft Lync Server 2010.

Sintaxe

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

New-CsServerApplication -Name <String> -Parent <String> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Aplicativos para servidores se referem a programas individuais que funcionam sob o Microsoft Lync Server 2010. O cmdlet New-CsServerApplication oferece aos administradores uma maneira de configurar novos aplicativos para servidores.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsServerApplication localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade Xds

Identificador único para o aplicativo para servidores a ser criado. As Identidades dos aplicativos para servidores são compostas pelo serviço no qual o aplicativo é hospedado, somado ao nome do aplicativo. Por exemplo, o aplicativo para servidores chamado QoEAgent pode ter uma identidade semelhante a esta: service:Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Parent

Obrigatório

Cadeia de caracteres

Especifica o serviço que irá hospedar o novo aplicativo para servidores. Usando o parâmetro Identity, não é necessário usar os parâmetros Parent ou Name; a identidade do aplicativo combina os valores das propriedades Parent e Name. No entanto, você pode omitir o parâmetro Identity usando os parâmetros Parent e Name em seu lugar. Nesse caso, o parâmetro Parent teria que ser parecido com: -Parent "Registrar:atl-cs-001.litwareinc.com".

Name

Obrigatório

Cadeia de caracteres

Nome amigável para o serviço. Se o parâmetro Identity for usado, não será necessário incluir o parâmetro Name ao criar um serviço novo; em vez disso, a propriedade Name será populada usando a porção de nome da identidade do aplicativo. Por exemplo, ao se criar um novo aplicativo com a identidade service:Registrar:atl-cs-001.litwareinc.com/TestService, o aplicativo será automaticamente nomeado TestService. O parâmetro Name só é necessário se o parâmetro Parent for utilizado.

Uri

Obrigatório

Cadeia de caracteres

URI (Uniform Resource Identifier) único do aplicativo. Por exemplo, o aplicativo QoEAgent tem a URI https://www.microsoft.com/LCS/QoEAgent.

Enabled

Opcional

Booleano

Defina esse valor como True para habilitar o aplicativo. Defina o valor como False para desabilitar o aplicativo. Se o parâmetro não for especificado, a propriedade Enabled será definida como False e o novo aplicativo será desabilitado.

Critical

Opcional

Booleano

Se for definido como True, o Lync Server não será iniciado, a não ser que o aplicativo em questão possa ser iniciado. Se for False, o Lync Server irá se iniciar independente do fato de o aplicativo poder ou não ser iniciado. Se o parâmetro não for especificado, a propriedade Critical será definida como True.

ScriptName

Opcional

Cadeia de caracteres

Caminho para o script MSPL (linguagem de processamento SIP da Microsoft) usado pelo aplicativo (se for o caso). A MSPL é uma linguagem de scripts usada para filtragem e roteamento de mensagens SIP.

Priority

Opcional

Inteiro

Indica a ordem de execução para aplicativos para servidores. O aplicativo com prioridade 0 é iniciado primeiro, o com prioridade 1 é iniciado em seguida e assim por diante. Observe que cada serviço que hospede um aplicativo para servidores tem seu próprio conjunto único de prioridades. Por exemplo, o serviço Registrador pode hospedar três aplicativos com as prioridades correspondentes 0, 1 e 2. De forma semelhante, o serviço Servidor de Borda pode ter quatro aplicativos; esses aplicativos terão as prioridades 0, 1, 2 e 3.

Se nenhuma prioridade for especificada, o aplicativo será adicionado automaticamente ao fim da lista de prioridades. Se você adicionar ou remover um aplicativo, as prioridades dos demais aplicativos serão devidamente ajustadas. Por exemplo, ao excluir um aplicativo com prioridade 0, o aplicativo que antes tinha prioridade 1 terá sua prioridade automaticamente definida como 0.

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

Force

Opcional

Parâmetro de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na 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

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. New-CsServerApplication não aceita entrada em pipeline.

Tipos de Retorno

New-CsServerApplication cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Exemplo

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

New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False

O Exemplo 1 cria um novo aplicativo para servidores com o parâmetro Identity EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor. Além de especificar o parâmetro Identity, os parâmetros Uri e Critical estão inclusos; eles especificam a URI do aplicativo e indicam que o aplicativo não é considerado crítico.

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

$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x

Os comandos mostrados no Exemplo 2 demonstram como criar um novo aplicativo para servidores que inicialmente exista apenas na memória. Para fazer isso, o primeiro comando chama New-CsServerApplication com dois parâmetros: Identity (que especifica a identidade do aplicativo) e InMemory, que indica que o novo aplicativo deve ser criado apenas na memória. O objeto de aplicativo de servidor resultante é armazenado na variável $x.

Depois que esse aplicativo virtual para servidores for criado, os comandos 2 e 3 serão usados para modificar os valores das propriedades Uri e Critical, respectivamente. Por fim, o comando 4 é usado para transformar o aplicativo virtual para servidores em um aplicativo real para servidores. Observe que esse último comando é obrigatório. Se Set-CsServerApplication não for chamado, nenhum aplicativo será configurado para EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor, e o aplicativo virtual irá desaparecer assim que sua sessão do Windows PowerShell for encerrada ou a variável $x for excluída.