Set-CsMediationServer
Tópico modificado em: 2012-03-26
Permite a modificação das propriedades de um ou mais Servidores de Mediação. Os Servidores de Mediação são usados para rotear tráfego entre sua infraestrutura interna do Enterprise Voice e um gateway de PSTN (rede telefônica pública comutada) ou um tronco SIP.
Sintaxe
Set-CsMediationServer [-Identity <XdsGlobalRelativeIdentity>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-Registrar <String>] [-SipClientTcpPort <UInt16>] [-SipClientTlsPort <UInt16>] [-SipServerPort <UInt16>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Os Servidores de Mediação agem como uma ponte entre sua configuração do Enterprise Voice interno e um gateway PSTN, IP-PBX ou um tronco SIP; por sua vez, isso oferece uma forma para seus usuários do Enterprise Voice (que estão usando os dispositivos VoIP) se comunicarem com pessoas usando telefones fixos padrões ou móveis. O cmdlet Set-CsMediationServer oferece uma forma de realizar alterações em um Servidor de Mediação existente. Em particular, é possível modificar as portas usadas para se comunicar com os dispositivos clientes, Servidores Front-End e pontos de gateways. Se necessário, o Set-CsMediationServer também pode ser usado para associar um Servidor de Mediação com um novo Registrador ou um novo Servidor de Borda.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsMediationServer 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-CsMediationServer"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade Xds |
Local do serviço do Servidor de Mediação a ser modificado. Por exemplo: -Identity "MediationServer:atl-cs-001.litwareinc.com". Observe que o prefixo "MediationServer:" pode ser deixado de fora ao especificar um Servidor de Mediação. Por exemplo: -Identity "atl-cs-001.litwareinc.com". |
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 (inclusive) serão usadas para tráfego de áudio. Um mínimo de sete portas de mídia é necessário para a retransmissão de uma única chamada de áudio. Duas portas de gateway. Uma porta é necessária para o tráfego do protocolo RTP, e a outra para o tráfego do protocolo RTCP. Duas portas de retransmissão de protocolo UDP, uma para tráfego RTP e outra para tráfego RTCP. Uma porta de retransmissão para protocolo TCP. Uma única porta de retransmissão de protocolo TCP pode lidar com tráfego RTP e RTCP. Duas portas locais por interface de rede, uma para tráfego RTP e outra para tráfego RTCP. |
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. |
EdgeServer |
Opcional |
Cadeia de caracteres |
Identidade de serviço do Servidor de Borda a ser associado ao Servidor de Mediação. Por exemplo: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
Registrar |
Opcional |
Cadeia de caracteres |
Identidade de serviço do Registrador a ser associado ao Servidor de Mediação. Por exemplo: -Registrar "Registrar:atl-cs-001.litwareinc.com". |
SipClientTcpPort |
Opcional |
Inteiro |
Porta de escuta usada para comunicação com pares de gateway usando TCP. Por padrão, nenhuma porta TCP está definida; porém, uma porta TCP com número de porta 5068 será criada automaticamente quando um gateway de PSTN for criado. Se você alterar SipClientTcpPort, será preciso reiniciar o serviço Servidor de Mediação para que a nova porta possa ser usada. |
SipClientTlsPort |
Opcional |
Inteiro |
Porta de escuta usada para comunicação com pares de gateway usando o protocolo TLS. Por padrão, SipClientTlsPort é configurado para usar a porta 5067. Se você alterar SipClientTlsPort, será preciso reiniciar o serviço Servidor de Mediação para que a nova porta possa ser usada. |
SipServerPort |
Opcional |
Inteiro |
Porta de escuta usada para se comunicar com o Servidores Front-End. Por padrão, SipServerPort é configurado para usar a porta 5070. Se você alterar o SipServerPort, precisará reiniciar o serviço do Servidor de Mediação antes da nova porta ser realmente usada. |
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-CsMediationServer não aceita entrada em pipeline.
Tipos de Retorno
Set-CsMediationServer não retorna nenhum objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.DisplayMediationServer.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsMediationServer -Identity "MediationServer:atl-cs-001.litwareinc.com" -SipClientTcpPort 5072
O comando mostrado no Exemplo 1 define a porta de escuta de gateway SIP como 5072 para o Servidor de Mediação MediationServer:atl-cs-001.litwareinc.com. Depois de mudar a porta, será preciso reiniciar o serviço de Mediação do Lync Server.
-------------------------- Exemplo 2 ------------------------
Set-CsMediationServer -Identity "MediationServer:atl-cs-001.litwareinc.com" -AudioPortStart 60000 -AudioPortCount 1000
O comando anterior define as configurações da porta de áudio para o Servidor de Mediação MediationServer:atl-cs-001.litwareinc.com. Neste exemplo, a porta de áudio inicial está definida como 60000 e o número total de portas alocadas para o áudio é de 1000.