Set-CsSite
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert die Eigenschaften für Ihre Microsoft Lync Server 2010-Standorte. Standorte stellen eine Ansammlung von Lync Server 2010-Pools dar und beziehen sich in der Regel auf geografische Bereiche. Lync Server umfasst zwei Arten von Standorten: Datencenter- und Remotestandorte (Zweigstellen).
Syntax
Set-CsSite [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-FederationRoute <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Lync Server 2010 führt in der Lync Server-Topologie ein neues Konzept ein: das der Standorte. Standorte (nicht zu verwechseln mit Active Directory-Standorten oder Microsoft Exchange Server-Standorten) sind Sammlungen von Lync Server-Pools und -Servern, die im Allgemeinen basierend auf geografischen Regionen und unter Berücksichtigung der Netzwerkbandbreite organisiert werden. Wenn alle Ihre Computer in Redmond sich beispielsweise im gleichen LAN mit Hochgeschwindigkeitsverbindungen mit geringer Latenz befinden, könnten Sie einen Standort "Redmond" einrichten, der diese Computer umfasst. Wenn die Computer in Dublin sich ebenfalls alle in einem eigenen LAN befinden und die gleichen Hochgeschwindigkeitsverbindungen mit geringer Latenz nutzen, könnten Sie einen separaten Standort "Dublin" einrichten. Standorte sind auch wichtig für die Verwaltung von Lync Server: Viele Richtlinien und Einstellungen können auf Standortebene konfiguriert werden, sodass es ohne Weiteres möglich ist, den Benutzern in Redmond einen Satz mit Wähleinstellungen und den Benutzern in Dublin andere Wähleinstellungen zuzuweisen.
Standorte werden mit dem Topologie-Generator erstellt, und auch alle Änderungen an der Standortinfrastruktur (beispielsweise das Hinzufügen neuer Pools) müssen ebenfalls mit dem Topologie-Generator durchgeführt werden. Sie können jedoch das Cmdlet Set-CsSite verwenden, um den Anzeigenamen, die Beschreibung und die Partnerverbundroute eines beliebigen Standorts in Ihrer Organisation zu ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsSite 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-CsSite"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Name des zu ändernden Standorts; Beispiel: -Identity "Redmond". Verwenden Sie zum Festlegen des Identitätswerts nicht das Format "site:Redmond". |
Description |
Optional |
Zeichenfolge |
Ermöglicht Administratoren das Hinzufügen zusätzlicher Informationen zu einem Standortobjekt. Beispielsweise kann die Beschreibung Kontaktinformationen für den Standort enthalten. |
DisplayName |
Optional |
Zeichenfolge |
Der Anzeigename des Standorts. Beispiel: -DisplayName "North America and South America". |
FederationRoute |
Optional |
Zeichenfolge |
Dienstidentifizierung des Edgeservers, der zum Bereitstellen einer Brücke zwischen Ihrem internen Netzwerk und dem Internet verwendet wird. Beispiel: -FederationRoute "EdgeServer:atl-edge-001.litwareinc.com". |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Bestätigungsaufforderungen oder Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Cmdlets 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
Keine. Set-CsSite akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Set-CsSite werden keine Objekte oder Werte zurückgegeben. Stattdessen ändert das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite".
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsSite -Identity Redmond -Description "Full-time employees in Redmond, WA."
Der in Beispiel 1 gezeigte Befehl ändert die Eigenschaft "Description" für den Standort Redmond (-Identity site:Redmond).
-------------------------- Beispiel 2 --------------------------
Set-CsSite -Identity Redmond -DisplayName "US Headquarters"
Mit dem vorstehenden Befehl wird der Anzeigename für den Standort Redmond in "US Headquarters" geändert.
-------------------------- Beispiel 3 --------------------------
Get-CsSite | Where-Object {$_.Description -eq $Null} | ForEach-Object {Set-CsSite $_.Identity -Description "Litwareinc.com"}
Der Befehl in Beispiel 3 findet alle Standorte, für die keine Beschreibung angegeben wurde, und weist anschließend jedem dieser Standorte die allgemeine Beschreibung "Litwareinc.com" zu. Hierzu ruft der Befehl zunächst Get-CsSite ohne Parameter auf, um eine Auflistung aller Lync Server-Standorte zurückzugeben. Die zurückgegebene Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Standorte herausfiltert, deren Eigenschaft "Description" einen Nullwert ($Null) aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Anschließend werden diese Standorte an das Cmdlet ForEach-Object weitergeleitet. Dieses Cmdlet bearbeitet die einzelnen Elemente in der Auflistung und ändert den Wert der Eigenschaft "Description" mithilfe von Set-CsSite.