Compartir a través de

  • Artículo

New-CsUserReplicatorConfiguration

 

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

Crea una nueva recopilación de opciones de configuración de replicador de usuarios. El replicador de usuarios recupera de manera periódica información actualizada de las cuentas de usuario de Active Directory y sincroniza la nueva información con los datos de usuario almacenados por Microsoft Lync Server 2010. Este cmdlet se ha diseñado para ser utilizado con Microsoft Lync Online 2010 y no funcionará con la versión local de Lync Server 2010.

Sintaxis

New-CsUserReplicatorConfiguration -Identity <XdsIdentity> [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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, Lync Server usa los datos de Active Directory como fuente de información de usuarios más fiable. Por ejemplo, al crear una cuenta de usuario de Active Directory, debe proporcionar información básica sobre la cuenta, como el nombre para mostrar de Active Directory. Sin embargo, cuando un usuario está habilitado para Lync Server, no necesita especificar un nuevo nombre para mostrar. El motivo es que Lync Server 2010 utiliza el nombre para mostrar que ya está almacenado en Active Directory.

La información de las cuentas de usuario, como el nombre para mostrar de Active Directory, puede cambiar en cualquier momento. Por ejemplo, si un usuario se casa, es posible que cambie su apellido y, a la vez, sea necesario cambiar su nombre para mostrar. Para garantizar que la base de datos de Lync Server y Active Directory se mantienen sincronizados, Lync Server debe comprobar periódicamente la información de Active Directory, recuperar los datos de cuentas de usuarios más actualizados y modificar la base de datos de Lync Server según corresponda. Esta sincronización entre Active Directory y Lync Server la lleva a cabo el replicador de usuarios.

Al instalar Lync Server 2010, se crea un conjunto global de opciones de configuración de replicador de usuarios. De forma predeterminada, se utilizan estas opciones 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 que el replicador de usuarios comprueba las actualizaciones de cuentas de usuarios de Active Directory. También puede crear recopilaciones adicionales en el ámbito de servicio, pero sólo si trabaja con Lync Online 2010.

Las opciones de configuración de replicador de usuarios se crean con el cmdlet New-CsUserReplicatorConfiguration. Tenga en cuenta que estas configuraciones sólo se pueden crear en el ámbito de servicio y para Lync Online 2010. No puede crear nuevas configuraciones del replicador de usuarios en la versión local de Lync Server.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet New-CsUserReplicatorConfiguration localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las opciones de configuración de replicador se usuarios que se van a crear. Las configuraciones sólo pueden crearse en el ámbito de servicio, y sólo para el servicio de registrador. Por tanto, las nuevas configuraciones deben tener un valor Identity similar a: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Tenga en cuenta que esto sólo se aplica a Lync Online 2010.

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 una sintaxis similar a ésta:

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

Puede agregar más de un nombre de dominio al llamar a New-CsUserReplicatorConfiguration. Para hacerlo, simplemente, separe los nombres de dominio con una coma:

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

Si define esta propiedad como un valor nulo, el replicador de servicios descubrirá todos los dominios disponibles y se sincronizará con ellos. Si esta propiedad no es nula, el replicador se sincronizará solamente con los dominios especificados en ADDomainNamingContextList.

ReplicationCycleInterval

Opcional

TimeSpan

Representa el tiempo que esperará el replicador de usuarios antes de comprobar si hay cuentas actualizadas en Active Directory. El intervalo de ciclo de replicación puede definirse como 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 en formato horas:minutos:segundos. Por ejemplo, con esta sintaxis se define el intervalo de tiempo en 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 sean graves y que puedan surgir 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-CsUserReplicatorConfiguration no acepta la entrada por canalización.

Tipos de valores devueltos

New-CsUserReplicatorConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.

Ejemplo

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

New-CsUserReplicatorConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

El comando del Ejemplo 1 crea una recopilación de opciones de configuración de replicador de usuarios para el servicio Registrar:atl-cs-001.litwareinc.com. No se especifican parámetros adicionales, por lo que la recopilación usará los valores de replicador de usuarios predeterminados.

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

New-CsUserReplicatorConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -ADDomaiNamingContextList @{Add="dc=fabrikam,dc=com","dc=contoso.com"}

El Ejemplo 2 también crea una recopilación de opciones de configuración de replicador de usuarios para el servicio Registrar:atl-cs-001.litwareinc.com. Aunque en este caso se agregan el parámetro ADDomainNamingContextList y los nombres distintivos de los dos dominios con los que se sincronizará: fabrikam.com y contoso.com. Esta nueva recopilación de opciones de configuración de replicador de usuarios sólo se configurará con estos dos dominios, aunque haya más dominios disponibles.