Set-CsPstnGateway
Última modificación del tema: 2012-03-26
Modifica las propiedades de la puerta de enlace de una red telefónica conmutada (RTC). Las puertas de enlace RTC ayudan a redirigir las llamadas entre los dispositivos en la red externa RTC y los dispositivos en la red interna de Enterprise Voice.
Sintaxis
Set-CsPstnGateway [-Identity <XdsGlobalRelativeIdentity>] [-AlternateByPassId <String>] [-Confirm [<SwitchParameter>]] [-Default <$true | $false>] [-Force <SwitchParameter>] [-GatewaySipClientTcpPort <Nullable>] [-GatewaySipClientTlsPort <Nullable>] [-MediationServer <String>] [-RepresentativeMediaIP <String>] [-Routable <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las puertas de enlace RTC habilitan a los usuarios de Enterprise Voice a realizar y recibir llamadas de teléfono de personas en la red RTC. Estas puertas de enlace actúan como puente entre la servidor de mediación y la red RTC.
Las puertas de enlace RTC generalmente son necesarias cuando se está usando un sistema telefónico de central pública de conmutación (PBX) con múltiplex por división de tiempo. En ese caso, generalmente, se debe emplear la puerta de enlace RTC y un servidor de mediación para enrutar las llamadas de Enterprise Voice hacia la red RTC. Por el contrario, si usa un sistema IP-PBX, puede crear una conexión SIP directa entre la PBX y la servidor de mediación, con lo cual ya no se necesita una puerta de enlace de RTC.
Una vez Instaladas y configuradas, las puertas de enlace RTC se pueden administrar mediante el uso del cmdlet Set-CsPstnGateway
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsPstnGateway localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPstnGateway"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identidad de servicio de la puerta de enlace RTC que se debe modificar. Por ejemplo: -Identity "PstnGateway:192.168.0.240". Tenga en cuenta que puede dejar el prefijo "PstnGatewayServer:" al especificar una puerta de enlace de RTC. Por ejemplo: -Identity "atl-cs-001.litwareinc.com". |
AlternateBypassId |
Opcional |
Identificador único global |
Identificador único global (GUID) que representa el identificador de desvío alternativa. Este identificador se genera automáticamente mediante Lync Server 2010 y se usa para ayudar a eliminar las llamadas "hairpin". Según se haya configurado el sistema, las llamadas 'hairpin' pueden desviar automáticamente el servidor de mediación sin que usted deba definir y asociar subredes individuales a todos los sitios y regiones. Para eso, generalmente se necesita habilitar la desviación globalmente para usar sitios y regiones de configuración de red, y habilitar la desviación en la configuración troncal de la puerta de enlace RTC. La llamada hairpin se produce cuando se vuelve a enrutar una llamada entrante desde la red RTC a esa red a través del desvío de llamadas o llamadas simultáneas. |
Default |
Opcional |
Booleano |
Si se establece en True, esta puerta de enlace administrará llamadas desde Office Communications Server 2007 R2. Solo puede haber una puerta de enlace predeterminada en la recopilación de puertas de enlace administradas por un único servidor de mediación. |
GatewaySipClientTcpPort |
Opcional |
Integer |
Puerto de escucha usado para comunicarse con servidores de mediación mediante el uso del Protocolo de control de transmisión (TCP). El valor predeterminado es 5066. |
GatewaySipClientTlsPort |
Opcional |
Integer |
Puerto de escucha usado para comunicarse con servidores de mediación mediante el uso del protocolo de seguridad de la capa de transporte (TLS). El valor predeterminado es 5067. |
MediationServer |
Opcional |
Cadena de caracteres |
Identidad de servicio del servidor de mediación que se debe asociar a la puerta de enlace RTC. Por ejemplo: -MediationServer "MediationServer:atl-cs-001.litwareinc.com". |
RepresentativeMediaIP |
Opcional |
Cadena de caracteres |
Dirección IP del procesador de medios asociado a la puerta de enlace, siempre que la ubicación del procesador sea distinta a la dirección de señalización. Tanto la desviación de medios como el control de admisión de llamadas (CAC) se basan en la ubicación del procesador de medios de la puerta de enlace; de forma predeterminada, es la misma ubicación que la dirección de señalización. Si las dos ubicaciones son diferentes (por ejemplo, con el procesador de medios en un sitio remoto y el par de señalización en el sitio central), RepresentativeMediaIP debe configurarse con la dirección IP del procesador de medios. Si ha implementado varios procesadores de medios en el mismo sitio, cada uno con su propia dirección IP, puede usar cualquiera de estas direcciones IP al configurar la propiedad RepresentativeMediaIP. |
Routable |
Opcional |
Booleano |
Cuando está establecida en True, la puerta de enlace se puede usar en rutas de enrutamiento de salida. |
Force |
Opcional |
Cadena de caracteres |
Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el cmdlet. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Get-CsPstnGateway no acepta entradas canalizadas.
Tipos de valores devueltos
Set-CsPstnGateway no devuelve ningún valor ni objeto. En su lugar, el cmdlet modifica instancias existentes del objeto Microsoft.Rtc.Management.Xds.DisplayPstnGateway.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsPstnGateway -Identity "PstnGateway:192.168.0.240" -Default $True
El comando que se muestra en el Ejemplo 1 configura la puerta de enlace PstnGateway:192.168.0.240 como la puerta de enlace predeterminada. Significa que PstnGateway:192.168.0.240 se puede usar para administrar llamadas provenientes de Office Communications Server 2007 R2.
-------------------------- Ejemplo 2 --------------------------
Get-CsService -PstnGateway | ForEach-Object {Set-CsPstnGateway -Identity $_.Identity -Routable $True}
El comando anterior configura todas las puertas de enlace RTC en la organización, lo que asegura que cada una de estas puertas de enlace se puedan usar en el enrutamiento de salida. Para realizar esto, el comando primero usa el cmdlet Get-CsService y el parámetro PstnGateway para devolver una recopilación de todas las puertas de enlace RTC actualmente en uso. A continuación, la recopilación se transfiere al cmdlet ForEach-Object. ForEach-Object se ejecuta en el cmdlet Set-CsPstnGateway para cada puerta de enlace de la recopilación, Para ello, se configura la propiedad Routable de cada puerta de enlace en True.