• Artikel

Publish-CsTopology

 

Letztes Änderungsdatum des Themas: 2012-03-25

Veröffentlicht die Microsoft Lync Server 2010-Topologie, die mit dem Cmdlet Get-CsTopology abgerufen wurde.

Syntax

Publish-CsTopology -FileName <String> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Publish-CsTopology -Document <XElement> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Publish-CsTopology -FinalizeUninstall <SwitchParameter> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Nach der Installation von Lync Server 2010 müssen Sie möglicherweise Änderungen an der Lync Server-Infrastruktur vornehmen; Sie müssen beispielsweise einen neuen Standort hinzufügen, einen bestehenden Registrierungspool löschen oder einen zusätzlichen Archivierungsserver hinzufügen. Diese Infrastrukturänderungen müssen Sie mit dem Topologie-Generator durchführen. Nachdem die Änderungen im Topologie-Generator vorgenommen wurden, können Sie sie mit diesem Tool veröffentlichen und aktivieren. Diese beiden letzen Schritte sind sehr wichtig. Wenngleich Sie im Topologie-Generator Ihren Anforderungen entsprechend so viele Änderungen wie nötig vornehmen können, werden diese für Ihre Lync Server-Infrastruktur erst wirksam, nachdem Sie die Änderungen veröffentlicht und die neue Topologie aktiviert haben.

Bei Veröffentlichung der Änderungen werden die neuen Informationen (z. B. ein neuer Standort oder eine neue Serverrolle) in den zentraler Verwaltungsspeicher geschrieben. Diese neuen (oder kurz zuvor geänderten) Objekte werden jedoch nicht sofort Teil der Topologie, sondern erst, nachdem die aktualisierte Topologie aktiviert wurde. Wenn Sie im Topologie-Generator die Option "Veröffentlichen" auswählen, werden die folgenden beiden Schritte ausgeführt: Die Änderungen werden veröffentlicht (d. h. in den zentraler Verwaltungsspeicher geschrieben), und dann wird die neue Topologie aktiviert.

Es wird nicht mehr empfohlen, mit dem Cmdlet Publish-CsTopology Topologien zu veröffentlichen, die mit dem Topologie-Generator erstellt wurden. Die Veröffentlichung sollte stattdessen im Topologie-Generator gemäß den im vorherigen Abschnitt beschriebenen Schritten erfolgen. Der Grund dafür ist, dass der Topologie-Generator jetzt das XML-Dateiformat (.tbxml) des Topologie-Generators verwendet; dieses Dateiformat kann nicht mit Publish-CsTopology veröffentlicht werden. Mit Publish-CsTopology können Sie nur eine Topologie erneut veröffentlichen, die mit dem Cmdlet Get-CsTopology abgerufen wurde. Nach der Veröffentlichung der Topologie auf diese Weise, müssen Sie Ihre einfachen URLs neu konfigurieren.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Publish-CsTopology auszuführen: RTCUniversalServerAdmins. Wenn die Setupberechtigungen jedoch nicht delegiert wurden, müssen Sie ein Domänenadministrator sein, um das Cmdlet Publish-CsTopology auszuführen. Damit RTCUniversalServerAdmins die Berechtigung erhalten, das Cmdlet Publish-CsTopology zu verwenden, müssen Sie das Cmdlet Grant-CsSetupPermission für jeden Active Directory-Container ausführen, der Computer enthält, auf denen Lync Server-Dienste ausgeführt werden. Beachten Sie, dass diese Einschränkung auch für die Aktivierung einer Topologie über den Topologie-Generator gilt. Wenn Sie die Berechtigungen nicht mit Set-CsSetupPermission delegiert haben, kann nur ein Domänenadministrator eine Topologie mit dem Topologie-Generator veröffentlichen.

Parameter

Parameter Erforderlich Typ Beschreibung

FileName

Erforderlich

Zeichenfolge

Vollständiger Pfad zur XML-Datei, die Informationen zur neuen Topologie enthält.

BackupFileName

Optional

Zeichenfolge

Vollständiger Pfad zu der Sicherungsdatei, die automatisch beim Ausführen von Publish-CsTopology erstellt wird. Wird dieser Parameter nicht angegeben, erstellt Publish-CsTopology im Ordner "Temp" (%temp%) eine Sicherungsdatei wie die folgende. Publish-CsTopology-Backup-[2010_10_01][08_30_00]. In diesem Dateinamen steht "2010_10_01" für das Datum der Veröffentlichung: Jahr (2010), Monat (10) und Tag (01). Zudem wird mit "08_30_00" die Uhrzeit der Veröffentlichung angegeben: Stunde (08), Minuten (30) und Sekunden (00).

Document

Optional

System.XML.Linq.XElement-Objekt

Ermöglicht das Veröffentlichen eines XML-Elements statt einer XML-Datei. Dieses XML-Element muss als System.XML.Linq.XElement-Objekt konfiguriert werden.

FinalizeUninstall

Optional

Switch-Parameter

Wird nur bei der Deinstallation von Lync Server 2010 verwendet. Nach Entfernen des zentralen Verwaltungsservers können Sie mit dem Cmdlet "CsTopology" und dem Parameter "FinalizeUninstall" eine leere Topologie veröffentlichen. Bei diesem Schritt werden alle Active Directory-Einträge für den zentralen Verwaltungsserver entfernt.

GlobalCatalog

Optional

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) eines globalen Katalogservers in Ihrer Domäne. Dieser Parameter ist nicht nötig, wenn Sie Publish-CsTopology auf einem Computer ausführen, für den es ein Konto in der Domäne gibt.

GlobalSettingsDomainController

Optional

Zeichenfolge

FQDN eines Domänencontrollers, auf dem die globalen Einstellungen gespeichert sind. Wenn die globalen Einstellungen im Systemcontainer von Active Directory-Domänendienste (AD DS) gespeichert sind, muss dieser Parameter auf den Stammdomänencontroller verweisen. Wenn die globalen Einstellungen im Konfigurationscontainer gespeichert sind, kann jeder Domänencontroller verwendet werden, und dieser Parameter kann ausgelassen werden.

SkipPrepareCheck

Optional

Boolescher Wert

Bei Festlegung auf "True" ($True) wird die erste Vorbereitungsprüfung von Publish-CsTopology übersprungen.

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\Publish_Topology.html"

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. Publish-CsTopology akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Keine. Mit Publish-CsTopology werden Instanzen des Objekts "Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology" veröffentlicht.

Beispiel

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

(Get-CsTopology -AsXml).ToString() > C:\Topologies\Topology.xml 
Publish-CsTopology -FileName "C:\Topologies\Topology.xml"

Die Befehle in Beispiel 1 rufen die aktuelle Topologie ab und veröffentlichen sie dann erneut. Hierzu verwendet der erste Befehl im Beispiel das Cmdlet Get-CsTopology und den Parameter "AsXml", um die aktuelle Topologie abzurufen. Das Windows PowerShell-Umleitungssymbol > wird dann dazu verwendet, um die abgerufenen Daten in der Datei "C:\Topologies\Topology.xml" zu speichern. (Beachten Sie, dass die ToString-Methode auch dazu verwendet wird, um die abgerufene Topologie in einen Zeichenfolgenwert zu konvertiert.) Der zweite Befehl im Beispiel verwendet dann Publish-CsTopology, um die neu abgerufene Topologie erneut zu veröffentlichen.