Compartir a través de

  • Artículo

Get-CsProxyConfiguration

 

Última modificación del tema: 2012-03-23

Devuelve información sobre las opciones de configuración de servidor proxy definidas en la organización.

Sintaxis

Get-CsProxyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Microsoft Lync Server 2010 permite administrar los servidores proxy mediante las opciones de configuración de servidor proxy. Estas opciones de configuración, que pueden aplicarse en el ámbito global y en el ámbito de servicio (aunque solo para los servicios del Servidor perimetral y de registrador) permiten controlar aspectos tales como los protocolos de autenticación que pueden usarse en los extremos cliente, y si se usará o no la compresión en las conexiones entrantes y salientes de servidor proxy. Al instalar Lync Server 2010, se crea una colección global de opciones de configuración de servidor proxy automáticamente. También puede crear recopilaciones adicionales en el ámbito de servicio.

El cmdlet Get-CsProxyConfiguration permite devolver información sobre cualquiera de las configuraciones de servidor proxy de la organización.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsProxyConfiguration: RTCUniversalUserAdmins, 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 "Get-CsProxyConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las opciones de configuración de servidor proxy que se devolverán. Para devolver la configuración global, use esta sintaxis: -Identity global. Para devolver la configuración definida en el ámbito de servicio, use una sintaxis similar a ésta: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com". Tenga en cuenta que no puede usar caracteres comodín para especificar una identidad. Si necesita usar caracteres comodín, use el parámetro Filter.

Si no incluye este parámetro, Get-CsProxyConfiguration devuelve todas las configuraciones de servidor proxy de la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín al especificar las opciones de configuración proxy que se devolverán. Por ejemplo, usando esta sintaxis se devuelven todas las configuraciones del ámbito de servicio: -Filter "service:*".

No se pueden usar los parámetros –Identity y –Filter en el mismo comando.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de proxy de la réplica local del Almacén de administración central en lugar de recuperarlos del propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsProxyConfiguration no acepta una entrada transferida.

Tipos de valores devueltos

Get-CsProxyConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsProxyConfiguration

El comando del Ejemplo 1 devuelve una recopilación de todas las configuraciones proxy en uso en la organización. Para ello, se llama a Get-CsProxyConfiguration sin parámetros.

-------------------------- Ejemplo 2 --------------------------

Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"

En el Ejemplo 2, se devuelve información sobre las opciones de configuración de proxy que tienen la identidad service:EdgeServer:atl-cs-001.litwareinc.com. Como las identidades deben ser únicas, este comando nunca devolverá más de una recopilación de configuraciones.

-------------------------- Ejemplo 3 --------------------------

Get-CsProxyConfiguration -Filter "service:*"

El comando anterior devuelve información sobre todas las configuraciones proxy configuradas en el ámbito de servicio. Para ello, el comando llama a Get-CsProxyConfiguration con el parámetro Filter; el valor de filtro "service:*" garantiza que sólo se devolverán las configuraciones con una identidad que comience con la cadena de caracteres "service:".

-------------------------- Ejemplo 4 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}

El Ejemplo 4 devuelve información sobre las configuraciones proxy que no permiten el uso de certificados de cliente como mecanismo de autenticación. Para ello, el comando primero usa Get-CsProxyConfiguration para devolver una recopilación de todas las configuraciones proxy en uso. Esta colección se transfiere al cmdlet Where-Object, que selecciona solamente las opciones de configuración en las que la propiedad UseCertificateForClientToProxyAuth es igual a False.

-------------------------- Ejemplo 5 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}

El comando anterior devuelve todas las configuraciones proxy en las que el tamaño máximo del cuerpo de mensajes de clientes es menor que 5000 kilobytes. Para ello, el comando primero llama a Get-CsProxyConfiguration sin parámetros, lo que devuelve una recopilación de todas las configuraciones proxy en uso. La colección se transfiere a Where-Object, que selecciona las configuraciones en las que la propiedad MaxClientMessageBodySizeKb es menor que 5000 días.