Compartir a través de

  • Artículo

Set-CsProxyConfiguration

 

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

Modifica una recopilación existente de configuraciones de servidor proxy.

Sintaxis

Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Microsoft Lync Server 2010 le permite administrar los servidores proxy a través de configuraciones de servidor proxy. Estas opciones de configuración, que pueden aplicarse en el ámbito global o en el ámbito del servicio (aunque sólo para los servicios Servidor perimetral y Registrar) lo habilitan para controlar funciones como los protocolos de autenticación que pueden usarse en los extremos cliente o si se usará compresión en las conexiones entrantes y salientes del servidor proxy. Al instalar Lync Server 2010, se crea una recopilació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 Set-CsProxyConfiguration proporciona un medio para que modifique los valores de propiedad de una recopilación existente de configuraciones de servidor proxy.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Set-CsProxyConfiguration en forma local: 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-CsProxyConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para las configuraciones de servidor proxy que deben modificarse. Para modificar la configuración global, use esta sintaxis: -Identity global. Para modificar las opciones configuradas en el ámbito de servicios, use una sintaxis similar a la siguiente: -Identity "service: EdgeServer:atl-edge-001.litwareinc.com".

Si no se incluye este parámetro, Set-CsProxyConfiguration modificará automáticamente las configuraciones globales.

Instance

Opcional

Objeto ProxySettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

AcceptClientCompression

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), el servidor proxy aceptará todas las solicitudes de compresión entrantes de los extremos de cliente.

AcceptServerCompression

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), el servidor proxy aceptará todas las solicitudes de compresión entrantes de otros servidores.

DisableNTLMFor2010AndLaterClients

Opcional

Booleano

Cuando se establece en True, los usuarios que inician sesión desde Microsoft Lync 2010 deben usar el protocolo Kerberos para autenticación. El valor predeterminado es False.

DNSCacheRecordCount

Opcional

Entero

Número máximo de registros que se puede mantener en la caché de registros de DNS. El valor predeterminado es 30000.

EnableWhiteSpaceKeepAlive

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), el servidor proxy espera que los clientes envíen periódicamente un "mensaje en blanco" (un mensaje vacío sin contenido) para indicar que su conexión aún está activa.

MaxClientCompressionCount

Opcional

Integer

Indica la cantidad máxima de conexiones cliente a servidor que pueden comprimirse en cualquier momento determinado; las conexiones adicionales que superen este límite no se comprimirán. El recuento de compresión puede establecerse en cualquier valor entero entre 0 y 65535, inclusive. El valor predeterminado es 15000.

MaxClientMessageBodySizeKB

Opcional

Integer

El tamaño máximo permitido (en kilobytes) para el cuerpo de un mensaje enviado desde un extremo de cliente. El valor predeterminado es de 128, lo que quiere decir que los mensajes con un tamaño superior a 128 KB serán rechazados. El tamaño de cuerpo del mensaje del cliente puede establecerse en cualquier valor entero entre 64 y 256, inclusive.

MaxServerCompressionCount

Opcional

Integer

Indica la cantidad máxima de conexiones servidor a servidor que pueden comprimirse en cualquier momento determinado; las conexiones adicionales que superen este límite no se comprimirán. El recuento de compresión de servidor puede establecerse en cualquier valor entero entre 0 y 65535, inclusive. El valor predeterminado es 1024.

MaxServerMessageBodySizeKB

Opcional

Integer

El tamaño máximo permitido (en kilobytes) para el cuerpo de un mensaje enviado desde otro servidor. El valor predeterminado es 5000, lo que significa que se rechazarán los mensajes con un tamaño de cuerpo mayor de 5000 KB. El tamaño de cuerpo del mensaje del servidor puede establecerse en cualquier valor entero entre 1000 y 20000, inclusive.

OutgoingTLSCount

Opcional

Integer

Especifica el número máximo de conexiones de seguridad de la capa de transporte (TLS) que pueden usarse para cada servidor interno. La cantidad mínima de conexiones TLS es 1, y la cantidad máxima es 4. En forma predeterminada, OutgoingTlsCount se establece en 4.

Realm

Opcional

Objeto SipProxy

Indica si las credenciales de seguridad están procesadas o no por el territorio del servidor de proxy predeterminado (SIP Communication Services) o por un territorio personalizado. Los territorios personalizados deben especificarse (y crearse) usando el cmdlet New-CsSipProxyCustom.

RequestServerCompression

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), el servidor proxy solicita que la compresión se use en todas las conexiones salientes a otros servidores.

TreatAllClientsAsRemote

Opcional

Booleano

Cuando se configura como True, el servidor proxy funciona como si todas las conexiones de cliente fueran conexiones externas que pasan por el Servidor perimetral. El valor predeterminado es False.

UseCertificateForClientToProxyAuth

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), los extremos de cliente podrán usar certificados para autenticación.

UseKerberosForClientToProxyAuth

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), los extremos de cliente podrán usar el protocolo Kerberos para autenticación. Si bien Kerberos es un protocolo más seguro que NTLM, no puede usarse si el cliente pertenece a un dominio diferente al servidor.

UseNtlmForClientToProxyAuth

Opcional

Booleano

Cuando se establece en True (el valor predeterminado), los extremos de cliente podrán usar el protocolo NTLM para autenticación. Si bien NTLM es un protocolo menos seguro que Kerberos, NTLM puede usarse si el cliente pertenece a un dominio diferente al servidor. Este no es el caso con la autenticación de Kerberos.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings. Set-CsProxyConfiguration acepta instancias canalizadas del objeto de configuraciones proxy.

Tipos de valores devueltos

Set-CsProxyConfiguration no devuelve un valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Ejemplo

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

Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True

En el Ejemplo 1, las opciones de configuración proxy con Identity service:EdgeServer:atl-edge-001.litwareinc.com se modifican para aceptar la compresión del servidor. Esto se realiza al llamar a Set-CsProxyConfiguration y al parámetro AcceptServerCompression y al establecer el valor de parámetro en True.

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

Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True

El comando anterior ubica todas las opciones de configuración proxy que aceptan compresiones de servidor y luego modifica estas configuraciones para aceptar también la compresión de cliente. Para ello, el comando primero llama a Get-CsProxyConfiguration sin ningún parámetro, a fin de devolver una recopilación de todas las configuraciones proxy en su organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, el cual selecciona únicamente aquellas directivas en las que la propiedad AcceptServerCompression es igual a True. A continuación, esta recopilación filtrada se canaliza al cmdlet Set-CsProxyConfiguration, que toma cada elemento en la recopilación y establece la propiedad AcceptClientCompression en True.

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

Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False

El Ejemplo 3 muestra cómo puede modificar todas las configuraciones proxy que se han configurado en el ámbito de servicio. A fin de realizar esto, el comando primero llama a Get-CsProxyConfiguration e incluye el parámetro Filter. El valor de filtro "service:*" asegura que solo se devuelvan las configuraciones que tienen una identidad que comience con el valor de cadena "service:". "site:". A continuación, esta recopilación filtrada se canaliza al cmdlet Set-CsProxyConfiguration, que toma cada elemento en la recopilación y establece la propiedad UseNtlmForClientToProxyAuth property en False.