Compartir a través de

  • Artículo

New-CsRegistrarConfiguration

 

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

Crea una nueva recopilación de opciones de configuración de registradores. 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

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

Descripción detallada

El registrador es quizás el componente más importante de Lync Server; sin un registrador, los usuarios no podrían iniciar sesión en el sistema, y Lync Server 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 en el que el usuario está iniciando sesión envía una solicitud de REGISTRO al registrador; a su vez, el servidor responde y le pide al dispositivo de cliente credenciales de autenticación. Si el cliente pasa el desafío (es decir, si el cliente presenta un conjunto válido de credenciales), el usuario se autentica y la información de extremo, tal como la dirección IP, el puerto y el nombre de usuario, inicia sesión en la base de datos de registro. Cuando un usuario cierra sesión, esta información se quita de la base de datos. Entre el inicio y el cierre de sesión, el registrador mantiene actualizada la información del estado y ayuda a enrutar los mensajes que se envían al usuario y se reciben de él.

Las opciones de configuración de registradores se usan para ayudar a manejar los extremos y las suscripciones a éstos; estas configuraciones se pueden aplicar en el ámbito global, del sitio o del servicio. (Las configuraciones en el ámbito de servicio solo se pueden usar con el servicio Registrador).

El cmdlet New-CsRegistrarConfiguration le permite crear nuevas opciones de configuración de registradores en el ámbito del sitio o del servicio. Tenga en cuenta que un sitio o servicio determinado solamente puede tener, como máximo, una recopilación de dichas configuraciones. Si intenta agregar una nueva recopilación a un sitio o servicio que ya hospeda una recopilación de opciones de configuración de registradores, el comando generará un error. Su comando también producirá un error si intenta crear nuevas configuraciones en el ámbito global.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para las opciones de configuración de registradores que deben crearse. Para crear las configuraciones establecidas en el ámbito del sitio, use una sintaxis similar a esta: -Identity site:Redmond. Para crear configuraciones en el nivel de servicio, use una sintaxis como esta: -Identity service:Registrar:atl-cs-001.litwareinc.com. Tenga en cuenta que un sitio o servicio determinado solamente puede tener, como máximo, una única recopilación de configuraciones de registradores. Si intenta crear una nueva recopilación con el parámetro Identity site:Redmond y el sitio Redmond ya hospeda una recopilación de configuraciones de registradores, su comando generará un error.

Además, no puede crear nuevos valores de registrador en el ámbito global. Si desea cambiar valores en el ámbito global, use el cmdlet Set-CsRegistrarConfiguration.

DefaultEndpointExpiration

Opcional

Integer

Cuando los extremos inician sesión, tienen la opción de solicitar un tiempo de espera de expiración. Este especifica el intervalo de tiempo en el que un extremo puede mantenerse registrado en el sistema antes de tener que ponerse en contacto con el servidor y solicitar una extensión. La propiedad DefaultEndpointExpiration representa el intervalo de tiempo de espera de expiración para los clientes que no solicitan un valor de tiempo de espera específico.

El DefaultEndpointExpiration debe tener 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 ubicar un registrador. Si se configura el valor True, los clientes enviarán un mensaje Inform de DHCP cuando inicien sesión 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

Integer

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 durante el cual 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 puede otorgarse a los clientes. Por ejemplo, si el tiempo máximo se establece en 600 segundos, y un cliente solicita un intervalo de tiempo de espera de 800 segundos, al cliente se le otorgará el período de expiración máximo permitido: 600 segundos.

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

MinEndpointExpiration

Opcional

Integer

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 durante el cual 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 puede otorgarse a los clientes. Por ejemplo, si el tiempo mínimo se establece en 600 segundos, y un cliente solicita un intervalo de tiempo de espera de 200 segundos, al cliente se le otorgará el período de expiración mínimo permitido: 600 segundos.

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

MaxEndpointsPerUser

Opcional

Integer

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

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.

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-CsRegistrarConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsRegistrarConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Ejemplo

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

New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True

El comando anterior crea una nueva recopilación de opciones de configuración de registradores para el sitio Redmond (-Identity site:Redmond). Además de especificar la identidad para las nuevas configuraciones, el comando también establece los extremos máximos por usuario en 4 (-MaxEndpointsPerUser 4) y permite el uso del servidor DHCP para registro del cliente (-EnableDHCPServer $True). Tenga en cuenta que este comando generará un error si ya se ha asignado una recopilación de opciones de configuración de registradores en el sitio Redmond.

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

$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory 
$x.MaxEndpointsPerUser = 4 
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x

El comando que se muestra en el Ejemplo 2 también crea una nueva recopilación de opciones de configuración de registradores para el sitio Redmond (-Identity site:Redmond). En este ejemplo, sin embargo, estas configuraciones se crean inicialmente sólo en la memoria y luego se aplican al sitio en sí.

A fin de llevar a cabo esta tarea, el primer comando usa New-CsRegistrarConfiguration para crear una nueva recopilación de configuraciones para site:Redmond; el parámetro InMemory se agrega al final del comando para asegurar que estas configuraciones se creen solo en la memoria y no se apliquen inmediatamente al sitio Redmond. Debido a que esta configuración existe sólo en la memoria, debe almacenarse en una variable; en este ejemplo, es una variable llamada $x.

En los comandos 2 y 3, se modifican dos propiedades de estas nuevas configuraciones virtuales (MaxEndpointsPerUser y EnableDHCPServer). El comando final en el ejemplo luego usa Set-CsRegistrarConfiguration para transformar las configuraciones virtuales almacenadas en $x en un conjunto real de opciones de configuración de registradores aplicadas al sitio Redmond. Si no se llama a Set-CsRegistrarConfiguration, no se crearán nuevas configuraciones para el sitio Redmond, y sus configuraciones virtuales desaparecerán tan pronto como finalice la sesión de Windows PowerShell o se elimine la variable $x.