Set-CsEdgeServer
Tópico modificado em: 2012-03-26
Modifica os valores de propriedade de um ou vários Servidores de Borda. Os Servidores de Borda são usados para fornecer conectividade entre a rede interna e a Internet.
Sintaxe
Set-CsEdgeServer [-Identity <XdsGlobalRelativeIdentity>] [-AccessEdgeClientSipPort <UInt16>] [-AccessEdgeExternalSipPort <Nullable>] [-AccessEdgeInternalSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-DataPsomClientPort <Nullable>] [-DataPsomServerPort <UInt16>] [-Force <SwitchParameter>] [-MediaCommunicationPortCount <UInt16>] [-MediaCommunicationPortStart <UInt16>] [-MediaRelayAuthEdgePort <UInt16>] [-MediaRelayExternalTurnTcpPort <UInt16>] [-MediaRelayExternalTurnUdpPort <UInt16>] [-MediaRelayInternalTurnTcpPort <UInt16>] [-MediaRelayInternalTurnUdpPort <UInt16>] [-Registrar <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
A conectividade com o mundo externo (ou seja, com a Internet) é um aspecto importante do Microsoft Lync Server 2010. Sem essa conectividade, os usuários devem fazer logon na rede interna para acessar o Lync Server 2010. Isso dificultaria a utilização do software por funcionários externos e impediria que os usuários que não possuem contas no seu domínio participem de conferências. Da mesma forma, sem a conectividade com o mundo externo, os usuários não poderiam trocar mensagens instantâneas com parceiros federados ou com pessoas que possuem contas em um sistema público de mensagens instantâneas, como Yahoo!, AOL ou MSN, por exemplo.
Os Servidores de Borda são usados para ajudar a fornecer conectividade entre a rede interna e a Internet. O cmdlet Set-CsEdgeServer permite modificar as definições de configuração do Servidor de Borda, uma tarefa que envolve principalmente a troca dos números de portas usadas na transmissão do tráfego de rede.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsEdgeServer localmente: 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 "Set-CsEdgeServer"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade de Xds |
O local do serviço do Servidor de Borda a ser modificado. Por exemplo: -Identity "EdgeServer:atl-edge-001.litwareinc.com". Observe que você pode omitir o prefixo "EdgeServer:" ao especificar um servidor de Borda. Por exemplo: -Identity "atl-cs-001.litwareinc.com". |
AccessEdgeClientSipPort |
Opcional |
Inteiro |
Porta usada para comunicações SIP entre o Servidor de Borda e dispositivos do cliente. O valor inicial é definido no Construtor de Topologias, mas pode ser alterado especificando um novo valor para este parâmetro. |
AccessEdgeExternalSipPort |
Opcional |
Inteiro |
Porta usada para o tráfego SIP externo. O valor padrão é 5061. |
AccessEdgeInternalSipPort |
Opcional |
Inteiro |
Porta usada para o tráfego SIP interno. O valor padrão é 5061. |
DataPsomClientPort |
Opcional |
Inteiro |
Porta usada para as comunicações do Modelo de objetos compartilhados persistentes (PSOM) entre o Servidor de Borda e os dispositivos clientes. O valor inicial é definido no Construtor de Topologias, mas pode ser alterado especificando um novo valor para este parâmetro. |
DataPsomServerPort |
Opcional |
Inteiro |
Porta usada para as comunicações PSOM entre o Servidor de Borda e outros servidores. |
MediaCommunicationPortCount |
Opcional |
Inteiro |
Número total de portas alocadas na Borda externa para comunicações de mídia. O valor padrão é 10000. |
MediaCommunicationPortStart |
Opcional |
Inteiro |
Número de porta inicial na Borda externa para as comunicações de mídia. O valor padrão é 50000. |
MediaRelayAuthEdgePort |
Opcional |
Inteiro |
Porta usada para a autenticação de retransmissão de mídia. O valor padrão é 5062. |
MediaRelayExternalTurnTcpPort |
Opcional |
Inteiro |
Porta usada para o tráfego de retransmissão de mídia externa usando o Protocolo de transmissão de controle (TCP). O valor padrão é 444 se seu servidor de Borda possui um único endereço IP. Se seu servidor de Borda possui vários endereços IP, o valor padrão é 443. Estes valores são definidos inicialmente no Construtor de Topologias, mas podem ser alterados especificando um novo valor para este parâmetro. |
MediaRelayExternalTurnUdpPort |
Opcional |
Inteiro |
Porta usada para o tráfego de retransmissão de mídia externa usando o Protocolo de datagrama de usuário (UDP). O valor padrão é 3478. |
MediaRelayInternalTurnTcpPort |
Opcional |
Inteiro |
Porta usada para o tráfego de retransmissão de mídia interna usando o TCP. O valor padrão é 443. |
MediaRelayInternalTurnUdpPort |
Opcional |
Inteiro |
Porta usada para o tráfego de retransmissão de mídia interna usando o UDP. O valor padrão é 3478. |
Registrar |
Opcional |
Cadeia de caracteres |
O local do serviço do Registrador a ser associado ao Servidor de Borda. Por exemplo: -Registrar "Registrar:atl-cs-001.litwareinc.com". |
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. |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. Set-CsEdgeServer não aceita a entrada canalizada.
Tipos de Retorno
Set-CsEdgeServer não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.DisplayEdgeServer.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
O comando exibido no Exemplo 1 modifica as portas SIP internas e externas do Servidor de Borda "EdgeServer:atl-edge-001.litwareinc.com".
-------------------------- Exemplo 2 ------------------------
Get-CsService -EdgeServer | Where-Object {$_.SiteId -eq "site:Redmond"} | ForEach-Object {Set-CsEdgeServer Identity $_.Identity -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062}
O Exemplo 2 modifica as portas SIP interna e externa de todos os Servidores de Borda localizados no site de Redmond. Para fazer isso, o comando usa primeiramente Get-CsService e o parâmetro EdgeServer, para retornar uma coleção de todos os Servidores de Borda em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os servidores de Borda do site de Redmond, ou seja, aqueles cuja propriedade SiteId for igual a site:Redmond. Essa coleção filtrada será então canalizada para o cmdlet For-Each-Object. Esse cmdlet executa Set-CsEdgeServer em cada servidor da coleção, alterando os valores atribuídos às propriedades AccessInternalSipPort e AccessExternalSipPort.