Compartir a través de


New-CsProxyConfiguration

 

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

Crea una nueva colección de valores de configuración de proxy.

Sintaxis

New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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>]]

Descripción detallada

Microsoft Lync Server 2010 permite administrar los servidores proxy a través de las opciones de configuración de servidor proxy. Estas opciones de configuración, que se pueden aplicar en el ámbito global o en el ámbito del servicio (si bien únicamente para los servicios de Servidor perimetral y de registrador) permiten controlar funciones como los protocolos de autenticación que se pueden usar en los extremos de clientes y si se usará compresión en las conexiones de servidor proxy entrantes y salientes. Al instalar Lync Server 2010, se crea una recopilación global de opciones de configuración de servidor proxy automáticamente. Como se ha mencionado, también puede crear colecciones adicionales en el ámbito de servicio. Estas nuevas colecciones se crean mediante el cmdlet New-CsProxyConfiguration.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsProxyConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsProxyConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para los valores de configuración de servidor proxy que se van a crear. Los valores de configuración del servidor proxy solamente pueden crearse como ámbito de servicio, y solamente para los servicios Servidor perimetral y de registrador. No puede crear ajustes para el ámbito global. De igual manera, no puede crear la configuración para el ámbito de servicios si el servicio en cuestión ya hospeda una colección de configuración de servidores proxy. Por ejemplo, si el servicio Registrar:atl-cs-001.litwareinc.com ya hospeda una configuración del servidor proxy, cualquier comando que intente crear una nueva configuración para dicho servicio provocará un error.

Para especificar la Identidad de la nueva configuración del servidor proxy, use una sintaxis como la que sigue: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

AcceptClientCompression

Opcional

Booleano

Cuando se configura como True (el valor predeterminado), el servidor proxy aceptará todas las demandas de compresión entrantes desde los extremos del cliente.

AcceptServerCompression

Opcional

Booleano

Cuando se configura como True (el valor predeterminado), el servidor proxy aceptará todas las demandas de compresión entrantes desde otros servidores.

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.

DisableNTLMFor2010AndLaterClients

Opcional

Booleano

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

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 la conexión aún está activa.

MaxClientCompressionCount

Opcional

Entero

Indica el número máximo de conexiones de cliente a servidor que pueden comprimirse en cualquier momento. Las conexiones adicionales que superen este límite no se comprimirán. La cuenta de compresión puede definirse en cualquier valor entero entre 0 y 65.535, ambos incluidos. El valor predeterminado es 15000.

MaxClientMessageBodySizeKB

Opcional

Entero

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 del cuerpo del mensaje del cliente puede configurarse como cualquier valor entero entre 64 y 256, ambos incluidos.

MaxServerCompressionCount

Opcional

Entero

Indica el número máximo de conexiones de servidor a servidor que pueden comprimirse en cualquier momento. Las conexiones adicionales que superen este límite no se comprimirán. La compresión de servidor puede definirse en cualquier valor entero entre 0 y 65.535, ambos incluidos. El valor predeterminado es 1.024.

MaxServerMessageBodySizeKB

Opcional

Entero

El tamaño máximo permitido (en kilobytes) para el cuerpo de un mensaje enviado desde otro servidor. El valor predeterminado es de 5.000, lo que quiere decir que los mensajes con un tamaño superior a 5.000 KB serán rechazados. El tamaño del cuerpo del mensaje del servidor puede configurarse como cualquier valor entero entre 1.000 y 20.000, ambos incluidos.

OutgoingTLSCount

Opcional

Entero

Especifica el número máximo de conexiones de Seguridad de la capa de transporte (TLS) que se puede usar para cada servidor interno. El número mínimo de conexiones TLS es 1 y el número máximo es 4. De manera predeterminada, OutgoingTlsCount se establece en 4.

Realm

Opcional

Objeto SipProxy

Indica si el dominio de servidor proxy predeterminado (SIP Communication Services) o un dominio personalizado ha procesado las credenciales de seguridad. Los dominios predeterminados deben especificarse (y crearse) mediante el uso del cmdlet New-CsSipProxyCustom.

RequestServerCompression

Opcional

Booleano

Cuando se configura como 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 establece en True, el servidor proxy funciona como si todas las conexiones de cliente fueran conexiones externas que pasan a través del Servidor perimetral que ejecuta el Servicio perimetral de acceso. El valor predeterminado es False.

UseCertificateForClientToProxyAuth

Opcional

Booleano

Cuando se configura como Verdadero (el valor predeterminado), los extremos del cliente tendrán permiso para usar certificados de autenticación.

UseKerberosForClientToProxyAuth

Opcional

Booleano

Cuando se configura como True (el valor predeterminado), los extremos del cliente tendrán permiso para usar el protocolo de autenticación Kerberos. Aunque Kerberos es un protocolo más seguro que NTLM, no puede emplearse si el cliente pertenece a un dominio diferente al del servidor.

UseNtlmForClientToProxyAuth

Opcional

Booleano

Cuando se configura como True (el valor predeterminado), los extremos del cliente tendrán permiso para usar el protocolo de autenticación NTML. Aunque NTML es un protocolo menos seguro que Kerberos, NTML puede emplearse si el cliente pertenece a un dominio diferente al del servidor. Esto no sucede con la autenticación Kerberos.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - 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. New-CsProxyConfiguration no acepta entradas transferidas.

Tipos de valores devueltos

New-CsProxyConfiguration crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Ejemplo

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

New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256

El comando anterior crea una nueva colección de valores de configuración de proxy para el servicio EdgeServer:atl-edge-001.litwareinc.com. Estos nuevos valores usan todos los valores de propiedad del servidor proxy, a excepción de dos: RequestServerCompression, que se establece en True, y MaxClientMessageBodySizeKb, que se establece en 256. Tenga en cuenta que este comando dará error si la configuración del servidor proxy ya se ha establecido para el servicio EdgeServer:atl-edge-001.litwareinc.com.

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

$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True 
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x

Los comandos que se demuestran en el Ejemplo 2 demuestran cómo crear una colección de valores de configuración del servidor proxy que, inicialmente, existan sólo en la memoria. Para hacerlo, el primer comando llama a New-CsProxyConfiguration junto con dos parámetros: Identidad (que especifica la Identidad de la configuración) e InMemory, que indica que la nueva configuración debe crearse sólo en la memoria. El objeto resultante se almacena en la variable $x.

Después de que se hayan creado estos valores virtuales, los comandos 2 y 3 se usan para modificar los valores de las propiedades RequestServerCompression y MaxClientMessageBodySizeKb respectivamente. Para acabar, el comando 4 se usa para transformar la configuración del servidor proxy virtual en una colección real de valores de configuración aplicada al servicio EdgeServer:atl-edge-001.litwareinc.com. Este último comando es obligatorio. Si no se llama a Set-CsProxyConfiguration, no se aplicará ninguna configuración a EdgeServer:atl-edge-001.litwareinc.com y la configuración virtual desaparecerá en cuanto termine la sesión de Windows PowerShell o elimine la variable $x.