Compartir a través de

  • Artículo

Set-CsUserReplicatorConfiguration

 

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

Modifica una colección existente de opciones de configuración del replicador de usuarios. El replicador de usuarios recupera de manera periódica información de cuentas de usuario actualizada de Active Directory Domain Services (AD DS) y sincroniza la nueva información con los datos de usuario almacenados por Microsoft Lync Server 2010.

Sintaxis

Set-CsUserReplicatorConfiguration [-Identity <XdsIdentity>] [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-CsUserReplicatorConfiguration [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Aunque Lync Server 2010 mantiene su propia base de datos de cuentas de usuarios e información de cuentas de usuario, Lync Server 2010 sigue dependiendo de AD DS como fuente de información de usuarios fiable. Por ejemplo, al crear una cuenta de usuario de Active Directory, debe proporcionar información básica sobre la cuenta de usuario, como el nombre para mostrar de Active Directory. Sin embargo, cuando un usuario se habilita para Lync Server, no es necesario especificar un nuevo nombre para mostrar, ya que Lync Server emplea el que ya está almacenado en AD DS.

La información de cuenta de usuario, incluido el nombre para mostrar de Active Directory, puede cambiar a lo largo del tiempo. Por ejemplo, si un usuario se casa, puede cambiar su apellido y, por lo tanto, será necesario cambiar también el nombre para mostrar correspondiente. Para garantizar que la base de datos de Lync Server y AD DS se mantienen sincronizados, Lync Server debe comprobar periódicamente la información de AD DS, recuperar los datos de cuentas de usuarios más actualizados y modificar base de datos de Lync Server según corresponda. Esta sincronización entre AD DS y Lync Server la lleva a cabo el replicador de usuarios.

Al instalar Lync Server, se crea automáticamente un conjunto global de opciones de configuración del replicador de usuarios. Estas opciones se usan de forma predeterminada para administrar el replicador de usuarios en toda la organización. (La administración del replicador de usuarios consiste en identificar los dominios que Lync Server necesita sincronizar, así como definir la frecuencia con la que comprueba las actualizaciones de cuentas de usuarios en AD DS.) De forma predeterminada, el replicador de usuarios detecta y sincroniza todos los dominios disponibles. No obstante, si usa la propiedad AdDomainNamingContextList, podrá limitar la sincronización a un conjunto de dominios concreto: los dominios que figuren en la propiedad AdDomainNamingContextList.

También puede crear más colecciones en el ámbito de servicio, pero solo si usa Microsoft Lync Online 2010.

El cmdlet Set-CsUserReplicatorConfiguration permite modificar cualquiera de las configuraciones del replicador de usuarios que se usan actualmente en la organización. Puede usar este cmdlet para agregar o quitar dominios de la lista de dominios con los que se sincroniza el replicador de usuarios, así como para modificar el intervalo de tiempo entre los ciclos de replicación.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsUserReplicatorConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles RBAC a los que este cmdlet rol se ha asignado (incluido cualquier otro rol RBAC personalizado que haya creado), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserReplicatorConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las opciones de configuración del replicador de usuarios que se van a modificar. Para modificar la configuración global, use la siguiente sintaxis: -Identity global.

Instance

Opcional

Objeto UserReplicatorConfiguration

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

ADDomainNamingContextList

Opcional

Modificador de lista PS

Nombres distintivos de los dominios de Active Directory con los que debe sincronizarse el replicador de usuarios. Por ejemplo, para agregar un dominio a la lista, use la siguiente sintaxis:

-ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}

Si establece esta propiedad en un valor nulo, el replicador de usuarios se sincronizará solamente con los dominios disponibles. Si esta propiedad no es nula, el replicador de usuarios únicamente se sincronizará con los dominios especificados en la propiedad ADDomainNamingContextList.

ReplicationCycleInterval

Opcional

TimeSpan

Representa el tiempo que esperará el replicador de usuarios antes de comprobar si hay cuentas actualizadas en AD DS. El intervalo de ciclo de replicación puede definirse en cualquier valor de tiempo entre 1 segundo y 23 horas, 59 minutos y 59 segundos. El valor predeterminado es de 1 minuto. El intervalo debe expresarse con el formato horas:minutos:segundos. Por ejemplo, esta sintaxis establece un intervalo de tiempo de una hora y 15 minutos:

-ReplicationCycleInterval 01:15:00

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir 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.UserReplicator.UserReplicatorConfiguration. Set-CsUserReplicatorConfiguration acepta entradas transferidas del objeto de configuración de replicador de usuarios.

Tipos de valores devueltos

Set-CsUserReplicatorConfiguration no devuelve ningún objeto ni valor. En su lugar, el cmdlet modifica la instancia global (la única que hay) del objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.

Ejemplo

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

Set-CsUserReplicatorConfiguration -Identity global -ReplicationCycleInterval "00:05:00"

El comando anterior establece el valor de ReplicationCycleInterval de la configuración global del replicador de usuarios en cinco minutos (00 horas: 05 minutos: 00 segundos).

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

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList $Null

El comando que se muestra en el Ejemplo 2 borra el valor de la propiedad ADDomainNamingContextList. Para ello, se incluye el parámetro ADDomainNamingContextList y el valor del parámetro se establece en nulo. Si establece este valor en nulo, el replicador de usuarios detectará y sincronizará automáticamente todos los dominios disponibles.

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

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}

En el Ejemplo 3 se agrega un nombre adicional a la propiedad ADDomainNamingContextList de la configuración global del replicador de usuarios. Para hacerlo, se usa la sintaxis @{Add=} junto con el nombre distintivo del dominio que se agrega. Al ejecutar este comando, se agregará fabrikam.com a la lista de nombres de dominio. Para configurar las opciones globales de modo que fabrikam.com sea el único de la lista, use esta sintaxis:

-ADDomainNamingContextList @{Replace="dc=fabrikam,dc=com"}

Cuando la propiedad AdDomainNamingContextList está establecida en valor distinto a nulo, el replicador de usuarios solo sincronizará los dominios enumerados en el valor de la propiedad. Éste sería el caso aun cuando existieran otros dominios en la implementación.

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

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Remove="dc=fabrikam,dc=com"}

En el ejemplo 4 se quita el dominio fabrikam.com de la propiedad ADDomainNamingContextList de las opciones de configuración global del replicador de usuarios. Para ello, se usa la sintaxis @{Remove=} junto con el nombre distintivo (DN) del dominio (dc=fabrikam,dc=com).