Artigo
01/15/2015

Set-CsApplicationServer

Tópico modificado em: 2012-03-27

Permite modificar propriedades de configuração de um ou mais servidores executando o Serviço de aplicativos. Esses servidores (também conhecidos como Servidores de Aplicativos) hospedam programas, como o Aplicativo de Estacionamento de Chamada, desenvolvidos usando-se o conjunto de Microsoft Unified Communications Managed API (UCMA).

Sintaxe

Set-CsApplicationServer [-Identity <XdsGlobalRelativeIdentity>] [-ApplicationDatabase <String>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AtsSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-CaaSipPort <UInt16>] [-CasSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-CpsSipPort <UInt16>] [-Force <SwitchParameter>] [-PdpSipPort <UInt16>] [-PdpTurnPort <UInt16>] [-Registrar <String>] [-RgsSipPort <UInt16>] [-RgsWcfMtlsPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Serviço de aplicativos hospeda vários programas do Microsoft Lync Server 2010 que não fazem parte dos componentes de servidor básicos; entre esses programas estão o Aplicativo Grupo de Resposta, o Aplicativo Atendedor de Conferência e o Aplicativo Comunicado de Conferência. O Serviço de aplicativos usa esses programas e os integra plenamente ao ambiente do Lync Server 2010.

O cmdlet Set-CsApplicationServer permite aos administradores modificar as definições de configuração de quaisquer (ou todos os) Servidores de Aplicativos implantados na organização. Por exemplo, é possível modificar as portas usadas para áudio, vídeo ou tráfego de compartilhamento de aplicativos, ou atribuir novos valores às portas usadas por aplicativos individuais como o Aplicativo Atendedor de Conferência ou o Aplicativo Comunicado de Conferência. Observe que ao alterar portas é necessário reiniciar o serviço correspondente.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsApplicationServer 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 "Set-CsApplicationServer"}

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Obrigatório	Xds Identity	Local do serviço do Servidor de Aplicativos a ser modificado. Por exemplo: -Identity "ApplicationServer:atl-cs-001.litwareinc.com". Observe que o prefixo "ApplicationServer:" pode ser deixado de fora ao especificar um Servidor de aplicativos. Por exemplo: -Identity "atl-cs-001.litwareinc.com".
ApplicationDatabase	Opcional	Cadeia de caracteres	Local de serviço do banco Banco de dados de aplicativos. Por exemplo: -ApplicationDatabase "ApplicationDatabase:atl-cs-001.litwareinc.com".
AppSharingPortCount	Opcional	Inteiro	Número total de portas alocadas para o compartilhamento de aplicativos. As portas a serem abertas começam com o valor configurado para AppSharingPortStart e continuam até o número de portas especificado para AppSharingPortCount. Por exemplo, se AppSharingPortStart for definido como 60000 e AppSharingPortCount for definido como 100, então as portas de 60000 a 60099 serão usadas para compartilhamento de aplicativos.
AppSharingPortStart	Opcional	Inteiro	Primeira porta no intervalo de portas alocadas para o compartilhamento de aplicativos. Por exemplo: –AppSharingPortStart 60000.
AtsSipPort	Opcional	Inteiro	Porta usada para o serviço de teste de áudio.
AudioPortCount	Opcional	Inteiro	Número total de portas alocadas para o envio e o recebimento de tráfego de áudio. As portas a serem abertas começam com o valor configurado para AudioPortStart e continuam até o número de portas especificado para AudioPortCount. Por exemplo, se AudioPortStart for definido como 60000 e AudioPortCount for definido como 100, então as portas de 60000 a 60099 serão usadas para tráfego de áudio.
AudioPortStart	Opcional	Inteiro	Primeira porta no intervalo de portas alocadas para o envio e o recebimento de tráfego de áudio. Por exemplo: –AudioPortStart 60000.
CaaSipPort	Opcional	Inteiro	Porta SIP usada pelo Aplicativo Atendedor de Conferência durante a conexão de usuários a uma conferência discada.
CasSipPort	Opcional	Inteiro	Porta SIP usada pelo Aplicativo Comunicado de Conferência para executar anúncios (por exemplo, "Ken Myer está saindo") durante uma conferência.
CpsSipPort	Opcional	Inteiro	Porta SIP usada pelo serviço Estacionamento de Chamada. O serviço Estacionamento de Chamada permite deixar uma chamada em espera em um telefone e recuperar essa chamada em um telefone diferente.
PdpSipPort	Opcional	Inteiro	Porta SIP usada pelo Ponto de Decisão de Política Server. O Ponto de Decisão de Política Server é usado para o gerenciamento da largura de banda.
PdpTurnPort	Opcional	Inteiro	Transformar porta de tráfego usada pelo Ponto de Decisão de Política Server.
Registrar	Opcional	Cadeia de caracteres	Nome de domínio totalmente qualificado do Registrador associado ao Ponto de Decisão de Política Server.
RgsSipPort	Opcional	Inteiro	Porta SIP usada pelo Aplicativo Grupo de Resposta. O Aplicativo Grupo de Resposta permite direcionar chamadas telefônicas recebidas para um grupo específico de pessoas, como para a equipe de suporte.
RgsWcfMtlsPort	Opcional	Inteiro	Porta usada para o tráfego MTLS do WCF (Windows Communication Foundation) usado pelo Aplicativo Grupo de Resposta.
VideoPortCount	Opcional	Inteiro	Número total de portas alocadas para o envio e o recebimento do tráfego de vídeo. As portas a serem abertas começam com o valor configurado para VideoPortStart e continuam até o número de portas especificado para VideoPortCount. Por exemplo, se VideoPortStart for definido como 60000 e VideoPortCount for definido como 100, então as portas de 60000 a 60099 serão usadas para tráfego de vídeo.
VideoPortStart	Opcional	Inteiro	Primeira porta no intervalo de portas alocadas para o envio e o recebimento de tráfego de vídeo. Por exemplo, –VideoPortStart 60000.
Force	Opcional	Parâmetros 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âmetros de opção	Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.
Confirm	Opcional	Parâmetros de opção	Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. Set-CsApplicationServer não aceita entrada em pipeline.

Tipos de Retorno

Set-CsApplicationServer não retorna nenhum objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.DisplayApplicationServer.

Exemplo

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

Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -CasSipPort 5074

O comando mostrado no Exemplo 1 configura a porta SIP do Aplicativo Comunicado de Conferência no Servidor de Aplicativos ApplicationServer:atl-cs-001.litwareinc.com como 5074.

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

Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -AudioPortStart 49500 -AudioPortCount 5500

O comando anterior configura portas de áudio para o Servidor de Aplicativos ApplicationServer:atl-cs-001.litwareinc.com. Nesse exemplo, a porta de áudio inicial é definida como 49500, e um total de 5500 portas são definidas para o tráfego de áudio.

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

Get-CsService -ApplicationServer | ForEach-Object {Set-CsApplicationServer -Identity $_.Identity -CasSipPort 5074}

No Exemplo 3, a porta SIP do Aplicativo Comunicado de Conferência é definida como 5074 para todos os Servidores de Aplicativos na organização. Para isso, o comando usa inicialmente Get-CsService para retornar uma coleção de todos os Servidores de Aplicativos em uso. Em seguida, essa coleção é redirecionada para o cmdlet ForEach-Object, que seleciona cada servidor na coleção e usa Set-CsApplicationServer para definir a porta SIP do Aplicativo Comunicado de Conferência como 5074.

Consulte Também

Outros Recursos

Get-CsServerApplication

Compartilhar via