Freigeben über

  • Artikel

Merge-CsLegacyTopology

 

Letztes Änderungsdatum des Themas: 2012-03-23

Mit dem Cmdlet Merge-CsLegacyTopology können Sie Topologieinformationen von Microsoft Office Communications Server 2007 R2 oder Microsoft Office Communications Server 2007 nach Microsoft Lync Server 2010 migrieren. Auf diese Weise wird eine Interoperabilität zwischen Lync Server 2010 und früheren Versionen der Software bereitgestellt.

Syntax

Merge-CsLegacyTopology -TopologyXmlFileName <String> [-UserInputFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Merge-CsLegacyTopology -Reserved <PSObject> [-UserInputFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Merge-CsLegacyTopology ist das erste Tool, das Sie bei der Migration von einer früheren Version von Office Communications Server (entweder Office Communications Server 2007 R2 oder Office Communications Server 2007) auf Lync Server 2010 verwenden. Merge-CsLegacyTopology wird zum Migrieren vertrauenswürdiger Diensteinträge und Topologieinformationen für die folgenden Komponenten verwendet: Domänen, Benutzerdienste, Registrierung, Vermittlungsserver und Edgeserver. Darüber hinaus werden mit dem Cmdlet vertrauenswürdige Diensteinträge für die Konferenzzentrale, Communicator Web Access und Konferenzverzeichnisse migriert. (Ein vertrauenswürdiger Diensteintrag ist ein Active Directory-Datensatz eines Servers, dem Lync Server vertraut.) Durch eine Zusammenführung der Topologieinformationen können Benutzer auf Lync Server mit Benutzern auf Communications Server 2007 oder Communications Server 2007 R2 kommunizieren.

Bevor Sie Merge-CsLegacyTopology ausführen können, müssen Sie zunächst das Schnittstellenpaket für Kompatibilität mit Windows Management Instrumentation (WMI) installieren. Diese Anwendung wird durch Ausführen der Datei "OCSWMIBC.msi" installiert. (Die Datei "OCSWMIBC.msi" finden Sie auf der Installations-DVD im Ordner "Setup".) Nach Installation des Schnittstellenpakets für Kompatibilität kann Merge-CsLegacyTopology aufgerufen werden. Merge-CsLegacyTopology verwendet WMI zum Auslesen von Legacydaten in der früheren Version von Office Communications Server. Anschließend erstellt es auf Basis dieser Daten entsprechende Objekte in Lync Server. Beispielsweise wird für jede in Ihrer Installation von Office Communications Server gefundene SIP-Domäne eine entsprechende SIP-Domäne in der neuen Installation von Lync Server erstellt.

Nach dem Ausführen von Merge-CsLegacyTopology sollten Sie die Cmdlets Import-CsLegacyConfiguration und Import-CsLegacyConferenceDirectory ausführen.

Das Cmdlet Merge-CsLegacyTopology muss mindestens zweimal ausgeführt werden: einmal zu Beginn einer Migration (zur Einführung der Communications Server 2007- oder Communications Server 2007 R2-Topologie), und einmal am Ende der Migration, wenn die vorherige Office Communications Server-Umgebung außer Betrieb gesetzt wurde. Darüber hinaus müssen Sie das Cmdlet bei jeder Änderung an Ihrer Legacy-Office Communications Server-Umgebung ausführen. Wenn Sie beispielsweise einen Vermittlungsserver hinzufügen oder einen Pool in der Office Communications Server-Topologie außer Betrieb setzen, müssen Sie erneut das Cmdlet Merge-CsLegacyTopology ausführen, um die geänderte Topologie zu importieren.

Die Cmdlets Import-CsLegacyConfiguration und Import-CsLegacyConferenceDirectory richten sich nach den Werten, die für Merge-CsLegacyTopology sind. Dies bedeutet, dass Sie möglicherweise Fehlermeldungen von Import-CsLegacyConfiguration oder Import-CsLegacyConferenceDirectory erhalten, in denen Sie aufgefordert werden, als mögliche Lösung für ein soeben aufgetretenes Problem das Cmdlet Merge-CsLegacyTopology auszuführen. Wenn Sie Merge-CsLegacyTopology nicht erneut ausführen, können weitere Fehler auftreten – insbesondere dann, wenn ein Element aus der Office Communications Server-Umgebung entfernt wurde, obwohl es weiterhin von Lync Server verwendet wird.

Wenn Sie Edgeserver aus einer vorherigen Installation von Office Communications Server zusammenführen möchten, müssen Sie zunächst eine benutzerdefinierte XML-Datei erstellen, die Ihren Edgeserver enthält. Sie müssen die Datei selbst erstellen, da Edgeservereinstellungen nicht in Active Directory gespeichert werden und daher von Merge-CsLegacyTopology nicht abgerufen werden können. Nachdem Sie diese XML-Datei erstellt haben (Informationen zur Erstellung dieser Datei finden Sie im Bereitstellungshandbuch zu Microsoft Lync Server 2010), müssen Sie den Pfad zu dieser Datei und den Parameter "UserInputFileName" einschließen, wenn Sie Merge-CsLegacyTopology ausführen. Andernfalls werden keine Edgeserver in die zusammengeführte Topologie eingeschlossen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Merge-CsLegacyTopology lokal auszufü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 "Merge-CsLegacyTopology"}

Parameter

Parameter Erforderlich Typ Beschreibung

TopologyXmlFileName

Erforderlich

Zeichenfolge

Pfad zur Ausgabedatei, die beim Ausführen von Merge-CsLegacyTopology erstellt wird. Beachten Sie, dass es sich bei dieser Datei nicht um die mit dem Parameter "Report" angegebene Datei handelt. Letztere wird für die Aufzeichnung von Fehlerinformationen verwendet, während die Topologie-XML-Datei die neu erstellte Lync Server-Topologie enthält. Diese Datei wird später zum Veröffentlichen der neuen Topologie verwendet.

Wenn die angegebene Datei bereits vorhanden ist, wird sie durch Ausführen von Merge-CsLegacyTopology überschrieben.

UserInputFileName

Optional

Zeichenfolge

Pfad zur XML-Datei für das Importieren von Edgeserver-Daten aus einer früheren Version von Office Communications Server. Diese XML-Datei (die Sie gemäß den Richtlinien im Bereitstellungshandbuch zu Lync Server 2010 selbst erstellen müssen) ist erforderlich, da Einstellungen für Edgeserver nicht in Active Directory-Domänendienste (AD DS) gespeichert werden. Wenn Sie keine Informationen zu Edgeservern importieren müssen, können Sie diesen Parameter auslassen.

Wenn Sie diesen Parameter nicht verwenden, funktionieren der Remotezugriff und der externe Zugriff (einschließlich Partnerverbund) in einer Umgebung, in der sowohl Communications Server 2007 R2 oder Communications Server 2007 R2 als auch Lync Server ausgeführt wird, möglicherweise nicht wie erwartet.

Force

Optional

Switch-Parameter

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

Report

Optional

Zeichenfolge

Ermöglicht es Ihnen, einen Dateipfad für die bei der Ausführung des Cmdlets erstellte Protokolldatei anzugeben. Beispiel: -Report "C:\Logs\MergeTopology.html"

Reserved

Optional

PS-Topologieobjekt

Ermöglicht das Zusammenführen der Topologie mithilfe eines Topologieobjekts anstelle einer XML-Topologiedatei.

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. Merge-CsLegacyTopology akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Merge-CsLegacyTopology gibt keine Objekte oder Werte zurück.

Beispiel

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

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml

Der in Beispiel 1 gezeigte Befehl führt Topologieinformationen und vertrauenswürdige Diensteinträge aus Communications Server 2007 R2 oder Communications Server 2007 mit einer neuen Installation von Lync Server zusammen. Der erforderliche Parameter "TopologyXmlFileName" wird dazu verwendet, den Pfad zur Ausgabedatei anzugeben, die beim Ausführen von Merge-CsLegacyTopology erstellt wird.

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

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml -UserInputFileName C:\EdgeServers.xml

Beispiel 2 ist eine Variante des in Beispiel 1 verwendeten Befehls. In Beispiel 2 wird jedoch der Parameter "UserInputFileName" eingeschlossen, um Edgeserverinformationen in die Topologie aufzunehmen. Der Parameterwert "C:\EdgeServers.xml" verweist auf eine benutzerdefinierte XML-Datei mit Edgeserverinformationen für Office Communications Server.