Compartir a través de


Set-CsRegistrarConfiguration

 

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

Modifica los valores de las propiedades de una colección existente de opciones de configuración de registrador. Los registradores se usan para autenticar solicitudes de inicio de sesión y para mantener la información sobre la disponibilidad y el estado del usuario.

Sintaxis

Set-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El posible que el registrador sea el componente más importante de Microsoft Lync Server 2010; sin un registrador, los usuarios no podrían iniciar sesión en el sistema, y Lync Server 2010 no podría realizar un seguimiento de los usuarios ni de su estado actual. Cuando un usuario inicia sesión en Lync Server, el extremo desde el que se registra el usuario envía una solicitud REGISTER al registrador. A su vez, el servidor responde solicitando al dispositivo del cliente las credenciales de autenticación. Si el cliente supera este paso (es decir, si presenta un conjunto válido de credenciales), el usuario estará autenticado y la información del extremo, como dirección IP, puerto y nombre de usuario, se registrará en la base de datos de registro. Cuando un usuario cierra sesión, se quita esta información de la base de datos. Entre el inicio y el cierre de sesión, el registrador mantiene actualizada la información y ayuda a enrutar los mensajes que se envían al usuario y se reciben de él.

La configuración del registrador se usa para ayudar a manejar los extremos y las suscripciones de extremos. La configuración se puede aplicar en el ámbito global, de sitio o de servicio. (Las configuraciones del ámbito de servicio solo se usan con el servicio registrador.) El cmdlet Set-CsRegistrarConfiguration se puede usar para modificar cualquiera de las colecciones de configuración de registrador que usa actualmente su organización (o todas ellas).

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las opciones de configuración de registrador que se modificarán. Para modificar la configuración global, use la siguiente sintaxis: -Identity global. Para modificar la configuración definida en el ámbito de sitio, use la sintaxis siguiente: -Identity site:Redmond. Para modificar las opciones configuradas en el nivel de servicio, use la sintaxis siguiente: -Identity service:Registrar:atl-cs-001.litwareinc.com. Observe que la configuración del registrador solamente se puede aplicar al servicio de registrador. Aparecerá un mensaje de error si trata de aplicar estas configuraciones a cualquier otro servicio.

Instance

Opcional

Objeto RegistrarSettings

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

DefaultEndpointExpiration

Opcional

Entero

Cuando los extremos inician sesión, tienen la opción de solicitar un tiempo de espera de expiración; este valor especifica el intervalo de tiempo que un extremo puede permanecer con la sesión iniciada antes de ponerse en contacto con el servidor y solicitar una extensión. La propiedad DefaultEndpointExpiration representa el intervalo de tiempo de espera de expiración de los clientes que no soliciten un determinado valor de tiempo de espera.

DefaultEndpointExpiration debe estar entre 300 (5 minutos) y 900 (15 minutos). El valor predeterminado es 600 (10 minutos).

EnableDHCPServer

Opcional

Booleano

Indica si los extremos pueden usar servidores DHCP para buscar un registrador. Si es True, los clientes enviarán un mensaje Inform de DHCP cuando se inicien por primera vez; el servidor DHCP responderá enviando el nombre de dominio completo (FQDN) de un registrador que pueda usarse para iniciar sesión con el usuario.

MaxEndpointExpiration

Opcional

Entero

Cuando los extremos inician sesión, tienen la opción de solicitar un tiempo de espera de expiración; este valor especifica el intervalo de tiempo que un extremo puede permanecer con la sesión iniciada antes de ponerse en contacto con el servidor y solicitar una extensión. La propiedad MaxEndpointExpiration representa la cantidad de tiempo máxima que se puede conceder a los clientes. Por ejemplo, si el tiempo máximo establecido es 600 segundos y un cliente solicita un intervalo de tiempo de espera de 800 segundos, se aplicará al cliente el máximo periodo de expiración permitido: 600 segundos.

MaxEndpointExpiration debe estar entre 300 (5 minutos) y 900 (15 minutos). El valor predeterminado es 900.

MaxEndpointsPerUser

Opcional

Entero

Indica la cantidad máxima de extremos que puede tener conectados simultáneamente al sistema un usuario. Por ejemplo, si un usuario tiene la sesión iniciada en Lync Server 2010 con un equipo y un teléfono móvil, estará usando dos extremos. MaxEndPointsPerUser debe tener un valor entre 1 y 64, ambos incluidos. El valor predeterminado es 8.

MinEndpointExpiration

Opcional

Entero

Cuando los extremos inician sesión, tienen la opción de solicitar un tiempo de espera de expiración; este valor especifica el intervalo de tiempo que un extremo puede permanecer con la sesión iniciada antes de ponerse en contacto con el servidor y solicitar una extensión. La propiedad MinEndpointExpiration representa la cantidad de tiempo mínima que se puede conceder a los clientes. Por ejemplo, si el tiempo mínimo establecido es 600 segundos y un cliente solicita un intervalo de tiempo de espera de 200 segundos, se aplicará al cliente el mínimo periodo de expiración permitido: 600 segundos.

MinEndpointExpiration debe estar entre 300 (5 minutos) y 900 (15 minutos). El valor predeterminado es 300.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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.Registrar.RegistrarSettings. Set-CsRegistrarConfiguration acepta las instancias transmitidas del objeto de configuración de registrador.

Tipos de valores devueltos

Set-CsRegistrarConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Ejemplo

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

Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True

El comando anterior modifica las opciones de configuración del registrador que se aplican al sitio de Redmond (-Identity site:Redmond). En este ejemplo, el valor de la propiedad EnableDHCPServer se ha configurado como True.

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

Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8} | Set-CsRegistrarConfiguration -MaxEndpointsPerUser 8

En el Ejemplo 2, se modifican todas las opciones de configuración de registrador que permiten a los usuarios utilizar más de 8 extremos. Para hacerlo, el comando llama primero a Get-CsRegistrarConfiguration sin ningún parámetro; esta acción devuelve una colección de todas las opciones de configuración de registrador que se usan en la organización. A continuación, se transfiere esta colección a Where-Object, que extrae solo las configuraciones cuya propiedad MaxEndpointsPerUser es mayor que (-gt) 8. Para terminar, se transfiere la colección filtrada a Set-CsRegistrarCollection, que establece una cantidad máxima de 8 extremos en cada elemento de la colección.

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

Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False

El comando del Ejemplo 3 deshabilita el registro del cliente a través de DHCP en cada sitio de la organización que hospeda una colección de opciones de configuración de registrador. Para hacerlo, el comando llama a Get-CsRegistrarConfiguration junto con el parámetro Filter; el valor de parámetro "site:*" limita los datos devueltos para incluir solo las configuraciones definidas en el ámbito de sitio. A continuación, se transfiere esta colección a Set-CsRegistrarConfiguration, que usa el parámetro EnableDHCPServer y el valor de parámetro $False para impedir que los clientes usen un servidor DHCP para buscar un registrador.