Set-CsUserReplicatorConfiguration
Dernière rubrique modifiée : 2012-03-25
Modifie une collection existante de paramètres de réplication des utilisateurs. Le réplicateur d’utilisateurs récupère régulièrement des informations de comptes d’utilisateurs à jour d’services de domaine Active Directory (AD DS), puis les synchronise avec les données utilisateur actuelles stockées par Microsoft Lync Server 2010.
Syntaxe
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>]]
Description détaillée
Bien que Lync Server 2010 dispose de sa propre base de données de comptes d’utilisateurs et de ses propres données de comptes d’utilisateurs, Lync Server 2010 s’appuie sur les services de domaine Active Directory (AD DS) comme source d’informations utilisateur à jour. Par exemple, quand un nouveau compte d’utilisateur Active Directory est créé, vous devez fournir les informations de base concernant le compte (tel que le nom complet Active Directory). Toutefois, lorsqu’un utilisateur est activé pour Lync Server, il est inutile de spécifier un nouveau nom complet. C’est parce que Lync Server utilise le nom complet déjà stocké dans AD DS.
Les informations de compte d’utilisateur, y compris le nom complet Active Directory, peuvent changer au fil du temps. Par exemple, une utilisatrice qui se marie peut changer de nom de famille et doit donc modifier son nom complet. Afin de garantir la synchronisation constante entre la base de données Lync Server et AD DS, Lync Server doit régulièrement vérifier AD DS, récupérer les dernières mises à jour des comptes d’utilisateurs et modifier sa propre base de données d’utilisateurs Lync Server en conséquence. Cette synchronisation entre AD DS et Lync Server est confiée au réplicateur d’utilisateurs.
Lorsque vous installez Lync Server, un ensemble de paramètres de configuration du réplicateur d’utilisateurs est créé pour vous. Par défaut, ces paramètres sont utilisés pour gérer le réplicateur d’utilisateurs à l’échelle de l’organisation. La gestion du réplicateur d’utilisateurs consiste à identifier les domaines avec lesquels Lync Server doit se synchroniser et déterminer la fréquence à laquelle le réplicateur d’utilisateurs vérifie AD DS pour y rechercher des mises à jour pour les comptes d’utilisateurs. Par défaut, le réplicateur d’utilisateurs découvre tous les domaines disponibles et se synchronise avec ceux-ci. Cependant, à l’aide de la propriété AdDomainNamingContextList, vous pouvez limiter la synchronisation à un ensemble de domaines spécifiques : les domaines qui apparaissent dans la propriété AdDomainNamingContextList.
Vous pouvez également créer d’autres collections au niveau de l’étendue Service, mais uniquement si vous travaillez avec Microsoft Lync Online 2010.
La cmdlet Set-CsUserReplicatorConfiguration vous permet de modifier les paramètres de réplication des utilisateurs actuellement utilisés dans votre organisation. Vous pouvez utiliser cette cmdlet pour ajouter ou supprimer des domaines de la liste de domaines avec lesquels le réplicateur d’utilisateurs doit se synchroniser, et modifier également l’intervalle de temps entre les cycles de réplication.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsUserReplicatorConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserReplicatorConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique des paramètres de configuration du réplicateur d’utilisateurs à modifier. Pour modifier les paramètres globaux, utilisez la syntaxe : -Identity global. |
Instance |
Facultatif |
Objet UserReplicatorConfiguration |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
ADDomainNamingContextList |
Facultatif |
Modificateur de liste PS |
Noms uniques des domaines Active Directory avec lesquels le réplicateur d’utilisateurs doit se synchroniser. Par exemple, pour ajouter un domaine à la liste, utilisez la syntaxe similaire à celle-ci : -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"} Si vous définissez cette propriété sur une valeur nulle, le réplicateur d’utilisateurs découvrira et se synchronisera avec tous les domaines disponibles. Si cette propriété n’est pas définie sur une valeur null, le réplicateur d’utilisateurs se synchronisera seulement avec les domaines spécifiés dans ADDomainNamingContextList. |
ReplicationCycleInterval |
Facultatif |
TimeSpan |
Représente la durée attendue par le réplicateur d’utilisateurs avant de vérifier les mises à jour des comptes d’utilisateurs dans AD DS. L’intervalle du cycle de réplication peut être n’importe quelle valeur de temps comprise entre 1 seconde et 23 heures, 59 minutes, et 59 secondes ; la valeur par défaut est de 1 minute. L’intervalle doit être exprimé à l’aide du format heures:minutes:secondes. Par exemple, cette syntaxe définit l’intervalle à 1 heure et 15 minutes : -ReplicationCycleInterval 01:15:00 |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration. Set-CsUserReplicatorConfiguration accepte la saisie de données transmises via le pipeline pour l’objet de configuration du réplicateur d’utilisateurs.
Types de retours
Set-CsUserReplicatorConfiguration ne retourne ni objet ni valeur. Au lieu de cela, la cmdlet modifie l’instance globale (la seule de ce type) de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ReplicationCycleInterval "00:05:00"
La commande précédente définit la valeur de ReplicationCycleInterval des paramètres globaux du réplicateur d’utilisateurs sur cinq minutes (00 heure : 05 minutes : 00 seconde).
-------------------------- Exemple 2 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList $Null
La commande illustrée à l’exemple 2 remet à zéro la valeur de la propriété ADDomainNamingContextList. Pour effectuer cette tâche, ajoutez le paramètre ADDomainNamingContextList, et définissez-lui une valeur nulle. Si vous définissez cette valeur sur null, le réplicateur d’utilisateurs découvrira et se synchronisera automatiquement avec tous les domaines disponibles.
-------------------------- Exemple 3 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}
Dans l’exemple 3, un nom supplémentaire est ajouté à la propriété ADDomainNamingContextList des paramètres globaux du réplicateur d’utilisateurs. Pour ce faire, c’est la syntaxe @{Add=} qui est utilisée ainsi que le nom unique du domaine ajouté. Une fois cette commande exécutée, fabrikam.com sera ajouté à la liste de noms de domaine. Pour configurer les paramètres globaux afin que fabrikam.com sur la liste utilise cette syntaxe :
-ADDomainNamingContextList @{Replace="dc=fabrikam,dc=com"}
Lorsque la propriété AdDomainNamingContextList est définie sur une valeur non nulle, le réplicateur d’utilisateurs se synchronise seulement avec les domaines répertoriés dans la valeur de la propriété. Ce sera le cas même s’il y a d’autres domaines dans le déploiement.
-------------------------- Exemple 4 --------------------------
Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Remove="dc=fabrikam,dc=com"}
L’exemple 4 supprime le domaine fabrikam.com de la propriété ADDomainNamingContextList des paramètres de configuration du réplicateur d’utilisateurs. C’est la syntaxe @{Remove=} qui est utilisée à cet effet, ainsi que le nom unique (DN) du domaine (dc=fabrikam,dc=com).
Voir aussi
Autres ressources
Get-CsUserReplicatorConfiguration
New-CsUserReplicatorConfiguration
Remove-CsUserReplicatorConfiguration