Set-CsRegistrar
Última modificación del tema: 2012-03-26
Permite modificar las propiedades de uno o más 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
Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-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 (ya sea un equipo, un teléfono móvil u otro dispositivo) envía una solicitud REGISTER al servidor de registro, que a su vez responde solicitando las credenciales de autenticación al dispositivo cliente. Si el cliente aprueba la autenticación (es decir, presenta un conjunto de credenciales válido), el usuario se autentica y la información de extremo, como la dirección IP, el puerto o el nombre de usuario, se guarda 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.
El cmdlet Set-CsRegistrar permite modificar las propiedades de uno o más registradores de la organización. Estas modificaciones incluyen cambiar la configuración del puerto, así como especificar la acción que debe emprenderse en caso de que el registrador no esté disponible.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Set-CsRegistrar: 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-CsRegistrar\b"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Ubicación de servicio del registrador que se va a modificar. Por ejemplo: -Identity "Registrar:atl-cs-001.litwareinc.com". Observe que no es necesario utilizar el prefijo "Registrar:" cuando se especifica un registrador. Por ejemplo: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Opcional |
Cadena de caracteres |
Ubicación de servicio del Servidor de archivado que se debe asociar al registrador. Por ejemplo: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
BackupRegistrar |
Opcional |
Cadena de caracteres |
Ubicación de servicio del registrador que se debe usar si este registrador no está disponible. Por ejemplo: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com". |
EdgeServer |
Opcional |
Cadena de caracteres |
Ubicación de servicio del Servidor perimetral que se debe asociar al registrador. Por ejemplo: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
EnableAutomaticFailover |
Opcional |
Booleano |
Si está configurado como True, se usará el registrador de reserva cuando el registrador principal no esté disponible. Si está configurado como False, no se usará el registrador de reserva si el registrador principal no está disponible. Este parámetro también afecta a los usuarios que se han registrado con un registrador de reserva. Si este parámetro se configura como True, dichos usuarios se quitarán del registrador de reserva y se volverán a registrar en el registrador primario cuando esté de nuevo disponible. |
FailbackDetectionInterval |
Opcional |
TimeSpan |
Especifica la cantidad de tiempo que el sistema debe esperar antes de comprobar si un registrador que no estaba disponible lo está ahora. Si establece EnableAutomaticFailover en True, el sistema "conmutará por error" al registrador de reserva siempre que el registrador no esté disponible. Es decir, el sistema tomará a los usuarios que tienen una sesión iniciada en el registrador donde se ha producido el error e intentará iniciarles una sesión en el registrador de reserva. La propiedad FailbackDetectionInterval especifica la cantidad de tiempo que esperará el sistema antes de comprobar si el registrador original vuelve a estar disponible. Si lo está, Lync Server intentará aplicar la "conmutación por recuperación" a ese registrador. La conmutación por recuperación significa sencillamente volver al registrador que se estaba usando inicialmente. En otras palabras, restablecer la sesión de los usuarios en su registrador original. Observe que la conmutación por recuperación es siempre un proceso automático. No se puede conmutar por recuperación manualmente de un registrador a otro. El intervalo de detección se puede establecer en cualquier valor entre 30 segundos y 84.400 segundos (24 horas). Especifique el intervalo de tiempo con el formato horas:minutos:segundos. Por ejemplo, para establecer el intervalo en 1 hora y 15 minutos: - FailbackDetectionInterval 01:15:00. Este parámetro no se puede usar a menos que haya especificado un registrador de reserva. |
FailureDetectionInterval |
Opcional |
TimeSpan |
Especifica el intervalo de tiempo que espera el sistema para decidir que el registrador ha dejado de estar disponible. Si EnableAutomaticFailover no se ha establecido en True, el sistema intentará iniciar las sesiones de los usuarios en el registrador de reserva. El intervalo de detección se puede establecer en cualquier valor entre 30 segundos y 84.400 segundos (24 horas). Especifique el intervalo de tiempo con el formato horas:minutos:segundos. Por ejemplo, para establecer el intervalo en 1 hora y 15 minutos: - FailureDetectionInterval 01:15:00. Este parámetro no se puede usar a menos que haya especificado un registrador de reserva. |
MonitoringServer |
Opcional |
Cadena de caracteres |
Ubicación de servicio del Servidor de supervisión que se debe asociar al registrador. Por ejemplo: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
Registrar |
Opcional |
Cadena de caracteres |
Ubicación de servicio del registrador. |
SipPort |
Opcional |
Entero |
Puerto usado para el tráfico SIP (Protocolo de inicio de sesión). |
SipHealthPort |
Opcional |
Cadena de caracteres |
Puerto que se utiliza para supervisar el estado del servidor. |
SipServerTcpPort |
Opcional |
Cadena de caracteres |
Puerto de escucha SIP. El valor predeterminado es 5060. |
UserServer |
Opcional |
Cadena de caracteres |
Ubicación de servicio del servidor de Servicios de usuarios que se debe asociar al registrador. Por ejemplo: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
WebPort |
Opcional |
Entero |
Puerto usado par la comunicación con los servidores web. |
WebServer |
Opcional |
Cadena de caracteres |
Ubicación de servicio del servidor web que se debe asociar con el registrador. Por ejemplo: -WebServer "WebServer:atl-cs-001.litwareinc.com". |
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
Ninguno. Set-CsRegistrar no acepta una entrada transferida.
Tipos de valores devueltos
Set-CsRegistrar no devuelve ningún objeto ni valor. En su lugar, el comando modifica las instancias existentes del objeto Microsoft.Rtc.Management.Xds.DisplayRegistrar.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
El comando del Ejemplo 1 configura el puerto SIP para el registrador Registrar:atl-cs-001.litwareinc.com to 5072.
-------------------------- Ejemplo 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
El comando anterior configura el puerto SIP para todos los registradores de la organización como 5072. Para ello, el comando primero usa Get-CsService y el parámetro Registrar para devolver una colección de todos los registradores que están en uso. Esta colección se transfiere al cmdlet ForEach-Object, que toma cada registrador de la colección y ejecuta el cmdlet Set-CsRegistrar para cambiar el puerto SIP a 5072.
-------------------------- Ejemplo 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
El Ejemplo 3 configura tanto un registrador de reserva (BackupRegistrar) como una conmutación automática por error (EnableAutomaticFailover) para el registrador Registrar:atl-cs-001.litwareinc.com.