Compartir a través de

  • Artículo

Remove-CsRegistrarConfiguration

 

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

Quita una recopilación de existente de configuraciones 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

Remove-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 Remove-CsRegistrarConfiguration le permite eliminar las opciones de configuración de registrador que se han aplicado en el ámbito del sitio o de servicio. Tenga en cuenta que esto no elimina ni desinstala ningún registrador; simplemente quita las configuraciones que rigen a esos registradores. Si estas configuraciones no existen en el ámbito del sitio o de servicio, el registrador se administrará con las configuraciones globales.

Remove-CsRegistrarConfiguration también se puede ejecutar con las configuraciones de registrador globales. Sin embargo, en ese caso, no se quitarán las configuraciones; eso ocurre porque las configuraciones globales no se pueden eliminar. En su lugar, todas las propiedades de esa recopilación global se restablecerán a sus valores predeterminados. Por ejemplo, si cambió el valor de la propiedad MinEndpointExpiration a 500, ese valor se restablecerá a 300.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-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 "Remove-CsRegistrarConfiguration e"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de las opciones de configuración de registrador que se quitarán. Para quitar opciones configuradas en el ámbito del sitio, use una sintaxis similar a: -Identity site:Redmond. Para quitar las configuraciones en el nivel de servicio, use una sintaxis como la siguiente: -Identity service:Registar:atl-cs-001.litwareinc.com.

Tenga en cuenta que Remove-CsRegistrarConfiguration también se puede ejecutar con las configuraciones globales (-Identity global). Sin embargo, en ese caso, no se quitará la recopilación global. En su lugar, todas las propiedades de la recopilación global se restablecerán a sus valores predeterminados.

Force

Requerido

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse 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. Remove-CsRegistrarConfiguration acepta entradas canalizadas del objeto de configuración de registrador.

Tipos de valores devueltos

Ninguno. En su lugar, Remove-CsRegistrarConfiguration elimina las instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Ejemplo

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

Remove-CsRegistrarConfiguration -Identity site:Redmond

El comando que se muestra en el Ejemplo 1 elimina las configuraciones de registrador asignadas en el sitio de Redmond. Cuando estas configuraciones se eliminan, los registradores del sitio de Redmond usarán, de manera automática, las configuraciones de registrador globales.

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

Get-CsRegistrarConfiguration -Filter "service:*" | Remove-CsRegistrarConfiguration

El comando anterior elimina todas las configuraciones de registrador que se asignaron en el ámbito de servicio. Para ello, el comando primero llama a Get-CsRegistrarConfiguration junto con el parámetro Filter; el valor de filtro "service:*" limita los datos devueltos a las configuraciones cuya Identidad comienza con los caracteres "service:". A continuación, la recopilación filtrada se transfiere a Remove-CsRegistrarConfiguration, que elimina cada elemento de la recopilación.

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

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

En el Ejemplo 3, se eliminan todas las configuraciones de registrador en las que la propiedad EnableDHCPServer se establece en True. Para realizar esta tarea, el comando primero llama a Get-CsRegistrarConfiguration sin parámetros; esto devuelve una recopilación de todas las opciones de configuración de registrador que se usan actualmente. Luego, esa recopilación se canaliza hacia el cmdlet Where-Object, el cual selecciona únicamente aquellas configuraciones donde la propiedad EnableDHCPServer es igual a True. En cambio, la recopilación filtrada se canaliza a Remove-CsRegistrarConfiguration, que elimina cada uno de los elementos de la recopilación.