• Artikel

New-CsUserReplicatorConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Auflistung von Konfigurationseinstellungen für den Benutzerreplikationsdienst. Der Benutzerreplikationsdienst ruft regelmäßig aktuelle Benutzerkontoinformationen aus Active Directory ab und synchronisiert die neuen Informationen mit den aktuellen Benutzerdaten, die in Microsoft Lync Server 2010 gespeichert sind. Dieses Cmdlet wurde für die Verwendung mit Microsoft Lync Online 2010 konzipiert und kann nicht mit der lokalen Version von Lync Server 2010 verwendet werden.

Syntax

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

Detaillierte Beschreibung

Lync Server 2010 verfügt zwar über eine eigene Datenbank für die Benutzerkonten und Benutzerkontendaten, Lync Server nutzt jedoch weiterhin Active Directory 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 2010 den Anzeigenamen verwendet, der bereits in Active Directory gespeichert ist.

Die Benutzerkontoinformationen, der Active Directory-Anzeigename eingeschlossen, können sich jedoch 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 Active Directory synchronisiert bleiben, muss Lync Server regelmäßig auf Active Directory zugreifen, die neuesten Benutzerkontoaktualisierungen abrufen und anschließend die Lync Server-Datenbank entsprechend ändern. Diese Synchronisierung zwischen Active Directory und Lync Server erfolgt über den Benutzerreplikationsdienst.

Bei der Installation von Lync Server 2010 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 Active Directory auf Benutzerkontoaktualisierungen überprüft. Außerdem können Sie zusätzliche Auflistungen auf Dienstebene erstellen. Dies gilt jedoch nur, wenn Sie mit Lync Online 2010 arbeiten.

Mit dem Cmdlet New-CsUserReplicatorConfiguration können Sie neue Konfigurationseinstellungen für den Benutzerreplikationsdienst erstellen. Beachten Sie, dass diese Einstellungen nur auf Dienstebene und nur für Lync Online 2010 erstellt werden können. Sie können keine neuen Benutzerreplikationseinstellungen für die lokale Version von Lync Server erstellen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsUserReplicatorConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zu erstellenden Konfigurationseinstellungen für den Benutzerreplikationsdienst. Einstellungen können nur auf Dienstebene und nur für den Registrierungsdienst erstellt werden. Neue Einstellungen müssen daher in etwa folgenden Identitätswert aufweisen: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Beachten Sie, dass dies nur für Lync Online 2010 gilt.

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"}

Sie können beim Aufruf von New-CsUserReplicatorConfiguration mehr als einen Domänennamen hinzufügen. Trennen Sie hierzu die Domänennamen durch ein Komma voneinander:

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

Wenn Sie diese Eigenschaft auf einen Nullwert setzen, erkennt und synchronisiert der Benutzerreplikationsdienst alle verfügbaren Domänen. Wenn diese Eigenschaft keinen Nullwert aufweist, führt der Replikationsdienst die Synchronisierung nur mit den in der Liste "ADDomainNamingContextList" aufgeführten Domänen durch.

ReplicationCycleInterval

Optional

TimeSpan

Stellt den Zeitraum dar, den der Benutzerreplikationsdienst abwartet, bevor er Active Directory auf Benutzerkontoaktualisierungen hin 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.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine. New-CsUserReplicatorConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsUserReplicatorConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration" erstellt.

Beispiel

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

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

Der Befehl in Beispiel 1 erstellt eine neue Auflistung von Konfigurationseinstellungen für den Benutzerreplikationsdienst für den Dienst "Registrar:atl-cs-001.litwareinc.com". Da keine weiteren Parameter angegeben wurden, verwendet die neue Auflistung die Standardwerte des Benutzerreplikationsdiensts.

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

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

In Beispiel 2 wird ebenfalls eine neue Auflistung von Konfigurationseinstellungen für den Benutzerreplikationsdienst für den Dienst "Registrar:atl-cs-001.litwareinc.com" erstellt. In diesem Fall wird jedoch "ADDomainNamingContextList" hinzugefügt, zusammen mit den Distinguished Names der beiden Domänen, für die eine Synchronisierung durchgeführt werden soll: "fabrikam.com" und "contoso.com". Diese neue Auflistung von Konfigurationseinstellungen für die Benutzerreplikation konfiguriert nur diese beiden Domänen, selbst wenn andere Domänen verfügbar sind.