• Artikel

Set-CsUserReplicatorConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Ändert eine vorhandene Auflistung von Konfigurationseinstellungen für den Benutzerreplikationsdienst. Der Benutzerreplikationsdienst ruft regelmäßig aktuelle Benutzerkontoinformationen aus Active Directory-Domänendienste (AD DS) ab und synchronisiert die neuen Informationen mit den aktuellen Benutzerdaten, die in Microsoft Lync Server 2010 gespeichert sind.

Syntax

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>]]

Detaillierte Beschreibung

Lync Server 2010 verfügt zwar über eine eigene Datenbank für Benutzerkonten und Benutzerkontendaten, Lync Server 2010 nutzt jedoch weiterhin AD DS als maßgebliche Quelle für Benutzerinformationen. Wenn beispielsweise ein neues Active Directory-Benutzerkonto erstellt wird, müssen Sie grundlegende Informationen über das Benutzerkonto bereitstellen (z. B. den Active Directory-Anzeigenamen). Wenn ein Benutzer jedoch für Lync Server aktiviert ist, müssen Sie keinen neuen Anzeigenamen angeben. Dies liegt daran, dass Lync Server den Anzeigenamen verwendet, der bereits in AD DS gespeichert ist.

Natürlich können sich Benutzerkontoinformationen, der Active Directory-Anzeigename eingeschlossen, im Laufe der Zeit ändern. Für einen Benutzer etwa, der heiratet und einen anderen Nachnamen annimmt, muss auch der Anzeigename geändert werden. Um sicherzustellen, dass die Lync Server-Datenbank und AD DS synchronisiert bleiben, muss Lync Server regelmäßig auf AD DS zugreifen, die neuesten Benutzerkontoaktualisierungen abrufen und anschließend die Lync Server-Benutzerdatenbank entsprechend ändern. Diese Synchronisierung zwischen AD DS und Lync Server erfolgt über den Benutzerreplikationsdienst.

Bei der Installation von Lync Server wird automatisch ein Satz globaler Konfigurationseinstellungen für den Benutzerreplikationsdienst erstellt. Standardmäßig werden diese Einstellungen zur organisationsweiten Verwaltung des Benutzerreplikationsdiensts verwendet. Zur Verwaltung des Benutzerreplikationsdiensts müssen Sie die Domänen angeben, die Lync Server für die Synchronisierung benötigt, und festlegen, wie oft der Benutzerreplikationsdienst AD DS auf Benutzerkontoaktualisierungen überprüft. Standardmäßig ermittelt der Benutzerreplikationsdienst alle verfügbaren Domänen und führt eine Synchronisierung mit diesen durch. Durch Verwendung der Eigenschaft "AdDomainNamingContextList" können Sie jedoch die Synchronisierung auf einen angegebenen Satz von Domänen beschränken: die Domänen, die in der Eigenschaft "AdDomainNamingContextList" aufgeführt sind.

Außerdem können Sie zusätzliche Auflistungen auf Dienstebene erstellen. Dies gilt jedoch nur, wenn Sie mit Microsoft Lync Online 2010 arbeiten.

Das Cmdlet Set-CsUserReplicatorConfiguration ermöglicht das Ändern der in Ihrer Organisation verwendeten Einstellungen für den Benutzerreplikationsdienst. Dieses Cmdlet ermöglicht das Hinzufügen von Domänen zur Liste der Domänen, mit denen der Benutzerreplikationsdienst synchronisiert werden muss, bzw. das Entfernen von Domänen aus dieser Liste. Ferner kann mit diesem Cmdlet das Zeitintervall zwischen Replikationszyklen geändert werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsUserReplicatorConfiguration lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zu ändernden Konfigurationseinstellungen für den Benutzerreplikationsdienst. Verwenden Sie folgende Syntax, um die globalen Einstellungen zu ändern: -Identity global.

Instance

Optional

UserReplicatorConfiguration-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

ADDomainNamingContextList

Optional

PS-Listenmodifizierer

Distinguished Names der Active Directory-Domänen, mit denen der Benutzerreplikationsdienst die Synchronisierung durchführen muss. Verwenden Sie beispielsweise eine Syntax wie die folgende, um der Liste eine Domäne hinzuzufügen:

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

Wenn Sie diese Eigenschaft auf einen Nullwert setzen, ermittelt der Benutzerreplikationsdienst alle verfügbaren Domänen und führt mit diesen eine Synchronisierung durch. Ist diese Eigenschaft nicht auf Null gesetzt, verwendet der Benutzerreplikationsdienst nur die in "ADDomainNamingContextList" angegebenen Domänen zur Synchronisierung.

ReplicationCycleInterval

Optional

TimeSpan

Stellt den Zeitraum dar, den der Benutzerreplikationsdienst abwartet, bevor er AD DS auf Benutzerkontoaktualisierungen prüft. Das Intervall des Replikationszyklus kann ein beliebiger Zeitwert zwischen 1 Sekunde und 23 Stunden, 59 Minuten und 59 Sekunden sein; der Standardwert lautet 1 Minute. Das Intervall muss im Format "Stunden:Minuten:Sekunden" angegeben werden. Beispielsweise setzt die folgende Syntax das Zeitintervall auf eine Stunde und 15 Minuten:

-ReplicationCycleInterval 01:15:00

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration-Objekt. Set-CsUserReplicatorConfiguration akzeptiert eine weitergeleitete Eingabe von Konfigurationsobjekten für den Benutzerreplikationsdienst.

Rückgabetypen

Set-CsUserReplicatorConfiguration gibt keine Objekte oder Werte zurück. Stattdessen ändert das Cmdlet die globale Instanz (die einzige solche Instanz) des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration".

Beispiel

-------------------------- Beispiel 1 ------------------------

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

Über den vorstehenden Befehl wird der Wert von "ReplicationCycleInterval" der globalen Einstellungen für den Benutzerreplikationsdienst auf 5 Minuten (00 Stunden: 05 Minuten: 00 Sekunden) festgelegt.

-------------------------- Beispiel 2 ------------------------

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList $Null

Über den in Beispiel 2 gezeigten Befehl wird der Wert der Eigenschaft "ADDomainNamingContextList" gelöscht. Zum Ausführen dieser Aufgabe wird der Parameter "ADDomainNamingContextList" aufgenommen, und der Wert wird auf Null gesetzt. Bei Einstellung dieses Werts auf Null ermittelt der Benutzerreplikationsdienst automatisch alle verfügbaren Domänen und führt mit diesen eine Synchronsierung durch.

-------------------------- Beispiel 3 ------------------------

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

In Beispiel 3 wird der Eigenschaft "ADDomainNamingContextList" der globalen Einstellungen für den Benutzerreplikationsdienst ein zusätzlicher Name hinzugefügt. Hierzu wird die Syntax @{Add=} sowie der Distinguished Name der Domäne verwendet, die hinzugefügt wird. Beim Ausführen dieses Befehls wird "fabrikam.com" zur Liste der Domänennamen hinzugefügt. Um die globalen Einstellungen so zu konfigurieren, dass nur "fabrikam.com" in der Liste enthalten ist, verwenden Sie die folgende Syntax:

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

Wenn die Eigenschaft "AdDomainNamingContextList" auf einen anderen Wert als Null gesetzt wird, führt der Benutzerreplikationsdienst die Synchronisierung nur mit den im Eigenschaftswert aufgeführten Domänen durch. Dies gilt auch dann, wenn in der Bereitstellung weitere Domänen enthalten sind.

-------------------------- Beispiel 4 ------------------------

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

In Beispiel 4 wird die Domäne "fabrikam.com" aus der Eigenschaft "ADDomainNamingContextList" der globalen Konfigurationseinstellungen für den Benutzerreplikationsdienst entfernt. Hierzu wird die Syntax "@{Remove=}" sowie der Distinguished Name der Domäne verwendet (dc=fabrikam,dc=com).