Set-CsEdgeServer
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert die Eigenschaftswerte für einen oder mehrere Edgeserver. Mithilfe von Edgeservern wird eine Verbindung zwischen Ihrem internen Netzwerk und dem Internet hergestellt.
Syntax
Set-CsEdgeServer [-Identity <XdsGlobalRelativeIdentity>] [-AccessEdgeClientSipPort <UInt16>] [-AccessEdgeExternalSipPort <Nullable>] [-AccessEdgeInternalSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-DataPsomClientPort <Nullable>] [-DataPsomServerPort <UInt16>] [-Force <SwitchParameter>] [-MediaCommunicationPortCount <UInt16>] [-MediaCommunicationPortStart <UInt16>] [-MediaRelayAuthEdgePort <UInt16>] [-MediaRelayExternalTurnTcpPort <UInt16>] [-MediaRelayExternalTurnUdpPort <UInt16>] [-MediaRelayInternalTurnTcpPort <UInt16>] [-MediaRelayInternalTurnUdpPort <UInt16>] [-Registrar <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Die Verbindung mit der Außenwelt (d. h. dem Internet) ist ein wichtiger Aspekt von Microsoft Lync Server 2010. Ohne diese Verbindung müssen Benutzer sich beim internen Netzwerk anmelden, um auf Lync Server 2010 zuzugreifen. Dies würde externen Benutzern die Verwendung der Software erschweren und Benutzer ohne Konto in Ihrer Domäne von vornherein von der Teilnahme an Konferenzen ausschließen. Genauso könnten Benutzer ohne Verbindung außerhalb der Organisation keine Sofortnachrichten mit Verbundpartnern oder Personen mit einem Konto bei einem öffentlichen Instant Messaging-System wie Yahoo!, AOL oder MSN austauschen.
Mithilfe von Edgeservern wird eine Verbindung zwischen Ihrem internen Netzwerk und dem Internet hergestellt. Mit dem Cmdlet Set-CsEdgeServer können Sie Konfigurationseinstellungen für die Edgeserver ändern, also in erster Linie die Portnummern, die zur Übertragung des Netzwerksverkehrs verwendet werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsEdgeServer 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-CsEdgeServer"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Dienstidentifizierung des zu ändernden Edgeservers. Beispiel: -Identity "EdgeServer:atl-edge-001.litwareinc.com". Beachten Sie, dass Sie das Präfix "EdgeServer:" beim Angeben eines Edgeservers auslassen können. Beispiel: -Identity "atl-cs-001.litwareinc.com". |
AccessEdgeClientSipPort |
Optional |
Ganze Zahl |
Port für die SIP-Kommunikation zwischen dem Edgeserver und Clientgeräten. Der anfängliche Wert ist in Topologie-Generator festgelegt, kann aber geändert werden, indem für diesen Parameter ein neuer Wert angegeben wird. |
AccessEdgeExternalSipPort |
Optional |
Ganze Zahl |
Port für den externen SIP-Datenverkehr. Der Standardwert lautet 5061. |
AccessEdgeInternalSipPort |
Optional |
Ganze Zahl |
Der für den internen SIP-Datenverkehr verwendete Port. Der Standardwert lautet 5061. |
DataPsomClientPort |
Optional |
Ganze Zahl |
Port für PSOM-Kommunikation (Persistent Shared Object Model) zwischen dem Edgeserver und den Clientgeräten. Der anfängliche Wert ist in Topologie-Generator festgelegt, kann aber geändert werden, indem für diesen Parameter ein neuer Wert angegeben wird. |
DataPsomServerPort |
Optional |
Ganze Zahl |
Port für die PSOM-Kommunikation zwischen dem Edgeserver und anderen Servern. |
MediaCommunicationPortCount |
Optional |
Ganze Zahl |
Gesamtanzahl der auf dem externen Edgeserver für die Medienkommunikation zugewiesenen Ports. Der Standardwert lautet 10000. |
MediaCommunicationPortStart |
Optional |
Ganze Zahl |
Erste Portnummer auf dem externen Edgeserver für die Medienkommunikation. Der Standardwert lautet 50000. |
MediaRelayAuthEdgePort |
Optional |
Ganze Zahl |
Port für die Mediarelayauthentifizierung. Der Standardwert lautet 5062. |
MediaRelayExternalTurnTcpPort |
Optional |
Ganze Zahl |
Port für den externen Mediarelayverkehr über TCP (Transmission Control Protocol). Der Standardwert lautet 444, wenn der Edgeserver eine einzelne IP-Adresse hat. Wenn der Edgeserver mehrere IP-Adresse hat, ist der Standardwert 443. Diese Werte sind anfänglich in Topologie-Generator festgelegt, können aber geändert werden, indem für diesen Parameter ein neuer Wert angegeben wird. |
MediaRelayExternalTurnUdpPort |
Optional |
Ganze Zahl |
Port für den externen Mediarelayverkehr über UDP (User Datagram Protocol). Der Standardwert lautet 3478. |
MediaRelayInternalTurnTcpPort |
Optional |
Ganze Zahl |
Port für den internen Mediarelayverkehr über TCP. Der Standardwert lautet 443. |
MediaRelayInternalTurnUdpPort |
Optional |
Ganze Zahl |
Port für den internen Mediarelayverkehr über UDP. Der Standardwert lautet 3478. |
Registrar |
Optional |
Zeichenfolge |
Dienstidentifizierung der Registrierung, die dem Edgeserver zugeordnet werden soll. Beispiel: -Registrar "Registrar:atl-cs-001.litwareinc.com". |
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 |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Keine. Set-CsEdgeServer akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Set-CsEdgeServer gibt keine Objekte oder Werte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayEdgeServer" geändert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
Der Befehl in Beispiel 1 ändert die internen und externen SIP-Ports für den Edgeserver "EdgeServer:atl-edge-001.litwareinc.com".
-------------------------- Beispiel 2 ------------------------
Get-CsService -EdgeServer | Where-Object {$_.SiteId -eq "site:Redmond"} | ForEach-Object {Set-CsEdgeServer Identity $_.Identity -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062}
In Beispiel 2 werden die internen und externen SIP-Ports für alle Edgeserver am Standort "Redmond" geändert. Dazu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "EdgeServer", um eine Auflistung aller Edgeserver zurückzugeben, die derzeit innerhalb der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Edgeserver vom Standort "Redmond" herausfiltert, d. h. Server, bei denen die Eigenschaft "SiteId" den Wert "site:Redmond" aufweist. Diese gefilterte Auflistung wird dann an das Cmdlet For-Each-Object weitergeleitet. Dieses Cmdlet führt Set-CsEdgeServer für alle Server in der Auflistung aus, wobei die den Eigenschaften "AccessInternalSipPort" und "AccessExternalSipPort" zugewiesenen Werte geändert werden.