Set-CsEdgeServer
Última modificación del tema: 2012-03-26
Modifica los valores de propiedad de uno o más servidores perimetrales. Los servidores perimetrales se usan para proporcionar conectividad entre la red interna e Internet.
Sintaxis
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>]]
Descripción detallada
La conectividad con el mundo exterior (es decir, con Internet) es un aspecto importante de Microsoft Lync Server 2010. Sin esta conexión, los usuarios tendrían que iniciar sesión en la red interna para obtener acceso a Lync Server 2010. Con estas condiciones, sería difícil usar el software para los usuarios que trabajan fuera de la oficina y se descartaría la posibilidad de que los usuarios sin cuentas en su dominio pudieran participar en las conferencias. Asimismo, sin conectividad con el mundo fuera de la organización, los usuarios no podrían intercambiar mensajes instantáneos con sus socios federados ni con las personas que tienen cuentas en un sistema público de mensajería instantánea, como Yahoo!, AOL o MSN.
Los servidores perimetrales se usan para proporcionar conectividad entre la red interna e Internet. El cmdlet Set-CsEdgeServer permite modificar las opciones de configuración de los servidores perimetrales, una tarea que, ante todo, implica cambiar los números de puerto usados para transmitir el tráfico de red.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsEdgeServer de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsEdgeServer"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Ubicación de servicio del Servidor perimetral que se va a modificar. Por ejemplo: -Identity "EdgeServer:atl-edge-001.litwareinc.com". Observe que no es necesario utilizar el prefijo "EdgeServer:" cuando se especifica un servidor perimetral. Por ejemplo: -Identity "atl-cs-001.litwareinc.com". |
AccessEdgeClientSipPort |
Opcional |
Entero |
Puerto usado para las comunicaciones SIP entre el Servidor perimetral y los dispositivos cliente. El valor inicial está definido en Topology Builder pero se puede cambiar especificando un nuevo valor para este parámetro. |
AccessEdgeExternalSipPort |
Opcional |
Entero |
Puerto usado para el tráfico SIP externo. El valor predeterminado es 5061. |
AccessEdgeInternalSipPort |
Opcional |
Entero |
Puerto usado para el tráfico SIP interno. El valor predeterminado es 5061. |
DataPsomClientPort |
Opcional |
Entero |
Puerto usado para las comunicaciones Modelo de objetos compartidos persistentes (PSOM) entre el Servidor perimetral y los dispositivos cliente. El valor inicial está definido en Topology Builder pero se puede cambiar especificando un nuevo valor para este parámetro. |
DataPsomServerPort |
Opcional |
Entero |
Puerto usado para las comunicaciones PSOM entre el Servidor perimetral y otros dispositivos. |
MediaCommunicationPortCount |
Opcional |
Entero |
Número total de puertos asignados en el servidor perimetral para comunicaciones de medios. El valor predeterminado es 10000. |
MediaCommunicationPortStart |
Opcional |
Entero |
Número inicial de puerto de la interfaz perimetral interna para comunicaciones de medios. El valor predeterminado es 50000. |
MediaRelayAuthEdgePort |
Opcional |
Entero |
Puerto usado para la autenticación de transmisión de medios. El valor predeterminado es 5062. |
MediaRelayExternalTurnTcpPort |
Opcional |
Entero |
Puerto usado para el tráfico externo de transmisión de medios mediante el Protocolo de control de transmisión (TPC). El valor predeterminado es 444 si el servidor perimetral tiene una sola dirección IP. Si tiene varias, el valor predeterminado es 443. Estos valores están definidos inicialmente en Topology Builder pero se pueden cambiar especificando un nuevo valor para este parámetro. |
MediaRelayExternalTurnUdpPort |
Opcional |
Entero |
Puerto usado para el tráfico externo de transmisión de medios mediante el Protocolo de datagramas de usuario (UDP). El valor predeterminado es 3478. |
MediaRelayInternalTurnTcpPort |
Opcional |
Entero |
Puerto usado para el tráfico interno de transmisión de medios mediante TCP. El valor predeterminado es 443. |
MediaRelayInternalTurnUdpPort |
Opcional |
Entero |
Puerto usado para el tráfico interno de transmisión de medios mediante UDP. El valor predeterminado es 3478. |
Registrar |
Opcional |
Cadena de caracteres |
Ubicación de servicio del registrador que se debe asociar con el Servidor perimetral. Por ejemplo: -Registrar "Registrar:atl-cs-001.litwareinc.com". |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Set-CsEdgeServer no acepta la entrada transferida.
Tipos de valores devueltos
Set-CsEdgeServer no devuelve ni valores ni objetos. En su lugar, el cmdlet modifica las instancias existentes del objeto Microsoft.Rtc.Management.Xds.DisplayEdgeServer.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
El comando mostrado en el Ejemplo 1 modifica los puertos SIP internos y externos del Servidor perimetral "EdgeServer:atl-edge-001.litwareinc.com".
-------------------------- Ejemplo 2 ------------------------
Get-CsService -EdgeServer | Where-Object {$_.SiteId -eq "site:Redmond"} | ForEach-Object {Set-CsEdgeServer Identity $_.Identity -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062}
En el Ejemplo 2 se modifican los puertos SIP internos y externos de todos los servidores perimetrales que se encuentran en el sitio de Redmond. Para ello, el comando primero usa Get-CsService y el parámetro EdgeServer para devolver una colección de todos los servidores perimetrales que actualmente están en uso en la organización. A continuación, la colección se transfiere al cmdlet Where-Object que solo selecciona los servidores perimetrales del sitio de Redmond; es decir, aquellos cuya propiedad SiteId sea igual a site:Redmond. La colección se transfiere al cmdlet For-Each-Object. Ese cmdlet ejecuta Set-CsEdgeServer con cada servidor de la colección, cambiando los valores asignados a las propiedades AccessInternalSipPort y AccessExternalSipPort.