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.
Vea también
Otros recursos
Get-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration