Compartir a través de

  • Artículo

Get-CsRegistrarConfiguration

 

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

Devuelve información sobre las opciones de configuración del registrador que actualmente se usa en la organización. 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

Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

El registrador es quizás 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 inicia sesión el usuario envía una solicitud REGISTER al registrador; a su vez, el servidor responde con una petición de las credenciales de autenticación al dispositivo cliente. 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 y ayuda a enrutar los mensajes que se envían al usuario y se reciben de él.

Las opciones de configuración del registrador se usan para ayudar a manejar los extremos y a las suscripciones de extremos; estas opciones de configuración se pueden aplicar en el ámbito global, de sitio o de servicio. (Las configuraciones en el ámbito de servicio solo se pueden usar con el servicio Registrador). El cmdlet Get-CsRegistrarConfiguration se usa para devolver información acerca de todas las recopilaciones de configuraciones de registrador que se usan actualmente en la organización.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsRegistrarConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-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 devolverán. Para volver a las configuraciones globales, use esta sintaxis: -Identity global. Para volver a las opciones configuradas en el ámbito del sitio, use una sintaxis similar a esta: -Identity site:Redmond. Para volver a las configuraciones en el nivel de servicio, use una sintaxis como la siguiente: -Identity service:Registrar:atl-cs-001.litwareinc.com.

Si este parámetro se suprime, Get-CsRegistrarConfiguration devuelve todas las opciones de registrador que se usan actualmente en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar comodines para devolver una o más recopilaciones de opciones de configuración de registrador. Por ejemplo, para devolver todas las configuraciones definidas en el ámbito de sitio, use la sintaxis: -Filter "site:*". Para devolver todas las configuraciones definidas en el ámbito de servicio, use esta sintaxis: -Filter "service:*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración del registrador desde la réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí.

Tipos de entrada

Ninguno. Get-CsRegistrarConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

Get-CsRegistrarConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Ejemplo

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

Get-CsRegistrarConfiguration

En el comando que se muestra en el Ejemplo 1, se devuelve una recopilación de todas las opciones de configuración de registrador actualmente en uso en la organización.

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

Get-CsRegistrarConfiguration -Identity site:Redmond

En el Ejemplo 2, se devuelve una sola recopilación de las opciones de configuración de registrador: las opciones configuradas para el sitio de Redmond (-Identity site:Redmond).

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

Get-CsRegistrarConfiguration -Filter "service:*"

En el Ejemplo 3, la información se devuelve para todas las opciones de configuración de registrador asignadas en el ámbito de servicio. Para hacerlo, el comando usa el parámetro Filter y el valor de filtro "service:*"; ese valor de filtro garantiza que se devolverán solo las configuraciones cuya Identidad comienza con el valor de cadena "service:" .

-------------------------- Ejemplo 4 --------------------------

Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}

En el Ejemplo 4, se devuelve información acerca de las opciones de configuración de registrador que habilitan el uso de servidores DHCP para registrar clientes. Para realizar esta tarea, el comando primero llama a Get-CsRegistrarConfiguration sin parámetros; eso devuelve una recopilación de todas las opciones de configuración de registrador que se usan actualmente. Luego, esta recopilación se canaliza hacia Where-Object, el cual selecciona únicamente aquellas configuraciones donde la propiedad EnableDHCPServer es igual a True.

-------------------------- Ejemplo 5 --------------------------

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

En el comando anterior, se devuelve la información para las configuraciones de registrador que permiten más de ocho extremos por usuario. Para ello, el comando primero usa Get-CsRegistrarConfiguration para devolver una recopilación de todas las configuraciones de registrador que, en la actualidad, se usan en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object , que elige solo aquellas configuraciones donde la propiedad MaxEndpointsPerUser es mayor a 8.