Set-CsPstnGateway
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert die Eigenschaften eines PSTN-Gateways (Public Switched Telephone Network, öffentliches Telefonfestnetz). PSTN-Gateways unterstützen das Weiterleiten von Anrufen zwischen Geräten im externen Telefonfestnetz und Geräten in Ihrem internen Enterprise-VoIP-Netzwerk.
Syntax
Set-CsPstnGateway [-Identity <XdsGlobalRelativeIdentity>] [-AlternateByPassId <String>] [-Confirm [<SwitchParameter>]] [-Default <$true | $false>] [-Force <SwitchParameter>] [-GatewaySipClientTcpPort <Nullable>] [-GatewaySipClientTlsPort <Nullable>] [-MediationServer <String>] [-RepresentativeMediaIP <String>] [-Routable <$true | $false>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
PSTN-Gateways ermöglichen Enterprise VoIP-Benutzern, Personen im Telefonfestnetz anzurufen und Anrufe von diesen zu empfangen. Diese Gateways fungieren als Brücke zwischen dem Vermittlungsserver und dem Telefonfestnetz.
PSTN-Gateways sind normalerweise erforderlich, wenn Sie eine TDM-Nebenstellenanlage (Time Division Multiplex Private Branch Exchange) verwenden. In diesem Fall müssen Sie in der Regel sowohl ein PSTN-Gateway als auch einen Vermittlungsserver einsetzen, um Enterprise-VoIP-Anrufe an das Telefonfestnetz weiterzuleiten. Wenn Sie im Gegensatz dazu eine IP-Nebenstellenanlage verwenden, können Sie eine direkte SIP-Verbindung zwischen der Nebenstellenanlage und dem Vermittlungsserver herstellen und auf ein PSTN-Gateway verzichten.
Nachdem PSTN-Gateways installiert und konfiguriert wurden, können sie mit dem Cmdlet Set-CsPstnGateway verwaltet werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsPstnGateway 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-CsPstnGateway"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Dienstidentität des zu ändernden PSTN-Gateways. Beispiel: -Identity "PstnGateway:192.168.0.240". Beachten Sie, dass Sie das Präfix "PstnGatewayServer:" beim Angeben eines PSTN-Gateways auch auslassen können. Beispiel: -Identity "atl-cs-001.litwareinc.com". |
AlternateBypassId |
Optional |
GUID |
GUID (Globally Unique Identifier), die die alternative ID für die Umgehung darstellt. Diese ID wird automatisch von Lync Server 2010 generiert und dient zum Vermeiden von HCR (Hairpin Call Routing). Je nach Konfiguration Ihres Systems kann HCR den Vermittlungsserver automatisch umgehen, ohne dass Sie einzelne Subnetze definieren und allen Standorten und Regionen zuordnen müssen. Hierzu müssen Sie in der Regel die Umgehung global aktivieren, um Netzwerkkonfigurationsstandorte und -regionen zu verwenden, und anschließend die Umgehung in der Trunkkonfiguration für Ihr PSTN-Gateway aktivieren. HCR liegt vor, wenn ein aus dem Telefonfestnetz eingehender Anruf über die Anrufweiterleitung oder über das gleichzeitige Klingeln an das Netzwerk zurückgeleitet wird. |
Default |
Optional |
Boolescher Wert |
Bei Festlegung auf "True" verarbeitet dieses Gateway Anrufe, die von Office Communications Server 2007 R2 gesendet werden. In der Auflistung von Gateways, die von einem einzelnen Vermittlungsserver verwaltet werden, kann es nur ein Standardgateway geben. |
GatewaySipClientTcpPort |
Optional |
Ganze Zahl |
Überwachter Port für die Kommunikation mit Vermittlungsservern über TCP (Transmission Control Protocol). Der Standardwert lautet 5066. |
GatewaySipClientTlsPort |
Optional |
Ganze Zahl |
Überwachter Port für die Kommunikation mit Vermittlungsservern über das TLS-Protokoll (Transport Layer Security). Der Standardwert lautet 5067. |
MediationServer |
Optional |
Zeichenfolge |
Dienstidentität des Vermittlungsservers, der dem PSTN-Gateway zugeordnet werden soll. Beispiel: -MediationServer "MediationServer:atl-cs-001.litwareinc.com". |
RepresentativeMediaIP |
Optional |
Zeichenfolge |
IP-Adresse des dem Gateway zugeordneten Medienprozessors, vorausgesetzt, der Prozessorstandort unterscheidet sich von der Signaladresse. Sowohl Medienumgehung als auch Anrufsteuerung basieren auf dem Standort des Gatewaymedienprozessors. Standardmäßig stimmt dieser mit der Signaladresse überein. Wenn sich die beiden Standorte unterscheiden (wenn der Medienprozessor sich beispielsweise an einem Remotestandort und der Signalpeer sich am zentralen Standort befindet), muss "RepresentativeMediaIP" mit der IP-Adresse des Medienprozessors konfiguriert werden. Wenn Sie mehrere Medienprozessoren mit jeweils einer eigenen IP-Adresse an demselben Standort bereitgestellt haben, können Sie eine dieser IP-Adressen bei der Konfiguration der Eigenschaft "RepresentativeMediaIP" verwenden. |
Routable |
Optional |
Boolescher Wert |
Bei Festlegung auf "True" kann das Gateway beim Ausgangsrouting verwendet werden. |
Force |
Optional |
Zeichenfolge |
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. Get-CsPstnGateway akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Set-CsPstnGateway werden keine Objekte oder Werte zurückgegeben. Stattdessen ändert das Cmdlet vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayPstnGateway".
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsPstnGateway -Identity "PstnGateway:192.168.0.240" -Default $True
Der Befehl in Beispiel 1 konfiguriert das Gateway "PstnGateway:192.168.0.240" als Standardgateway. Das heißt, dass "PstnGateway:192.168.0.240" zum Verarbeiten von Anrufen von Office Communications Server 2007 R2 verwendet werden kann.
-------------------------- Beispiel 2 --------------------------
Get-CsService -PstnGateway | ForEach-Object {Set-CsPstnGateway -Identity $_.Identity -Routable $True}
Mit dem vorstehenden Befehl werden alle PSTN-Gateways in der Organisation konfiguriert, sodass sicherstellt wird, dass alle diese Gateways für das Ausgangsrouting verwendet werden können. Hierzu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "PstnGateway", um eine Auflistung aller derzeit verwendeten PSTN-Gateways zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet ForEach-Object weitergeleitet. ForEach-Object führt das Cmdlet Set-CsPstnGateway für jedes Gateway in der Auflistung aus und setzt die Eigenschaft "Routable" jeweils auf "True".