New-CsUserReplicatorConfiguration

New-CsUserReplicatorConfiguration
    [-Identity] <XdsIdentity>
    [-ADDomainNamingContextList <PSListModifier>]
    [-ReplicationCycleInterval <TimeSpan>]
    [-Force]
    [-InMemory]
    [-WhatIf]
    [-Confirm]
    [-SkipFirstSyncAllowedDowntime <TimeSpan>]
    [<CommonParameters>]

Although Skype for Business Server maintains its own database of user accounts and user account data, Skype for Business Server still relies on Active Directory as the ultimate source for user information. For example, when a new Active Directory user account is created, you must supply basic information about the user account (such as the Active Directory display name). When a user is enabled for Skype for Business Server, however, you do not need to specify a new display name. That's because Skype for Business Server uses the display name already stored in Active Directory.

User account information, including the Active Directory display name, is subject to change over time. For example, a user who gets married might change her last name and, in turn, need to change her display name as well. In order to ensure that the Skype for Business Server database and Active Directory remain in synch, Skype for Business Server must periodically check in with Active Directory, retrieve the latest user account updates, and then modify the Skype for Business Server user database accordingly. This synchronization between Active Directory and Skype for Business Server is carried out by the User Replicator.

When you install Skype for Business Server a global set of User Replicator configuration settings is created for you. By default, these settings are used to manage the User Replicator on an organization-wide basis. Management of the User Replicator consists of identifying the domains that Skype for Business Server needs to synch with as well as indicating how often the User Replicator checks Active Directory for user account updates. You can also create additional collections at the service scope, but only if you are working with Skype for Business Online.

New User Replicator configurations settings are created using the New-CsUserReplicatorConfiguration cmdlet. Note that these settings can only be created at the service scope and only for Skype for Business Online. You cannot create new User Replicator settings for the on-premises version of Skype for Business Server.

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

The command shown in Example 1 creates a new collection of User Replicator configuration settings for the service Registrar:atl-cs-001.litwareinc.com. Because no additional parameters are specified, the new collection will use the default user replicator values.

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

Example 2 also creates a new collection of user replicator configuration settings for the service Registrar:atl-cs-001.litwareinc.com. In this case, however, the ADDomainNamingContextList is added, along with the distinguished names of the two domains to synchronize with: fabrikam.com and contoso.com. This new collection of user replicator configuration settings will only configure with those two domains, even if other domains are available.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

The New-CsUserReplicatorConfiguration cmdlet does not accept pipelined input.

The New-CsUserReplicatorConfiguration cmdlet creates new instances of the Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration object.