Set-CsTrunkConfiguration
Letztes Änderungsdatum des Themas: 2012-03-25
Ändert eine vorhandene Trunkkonfiguration, mit der die Einstellungen für eine Trunkpeerentität wie z. B. ein PSTN-Gateway, eine IP-Nebenstellenanlage oder einen SBC (Session Border Controller) des Dienstanbieters definiert werden.
Syntax
Set-CsTrunkConfiguration [-Identity <XdsIdentity>] [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Verwenden Sie dieses Cmdlet, um eine Trunkkonfiguration für PSTN-Gatewayentitäten zu ändern. Jede Konfiguration umfasst spezifische Einstellungen für eine Trunkpeerentität, wie z. B. ein PSTN-Gateway, eine IP-Nebenstellenanlage oder einen SBC (Session Border Controller) des Dienstanbieters. Diese Einstellungen konfigurieren beispielsweise, ob die Medienumgehung auf diesem Trunk aktiviert ist, ob unter bestimmten Bedingungen RTCP-Pakete (Real-Time Transport Control Protocol) gesendet werden und ob die sichere SRTP-Verschlüsselung (Secure Real-Time Transport Protocol) erforderlich ist.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsTrunkConfiguration 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-CsTrunkConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eine eindeutige ID, die den Gültigkeitsbereich der Trunkkonfiguration enthält. Trunkkonfigurationen können auf globaler oder auf Standortebene bzw. für einen PSTN-Gatewaydienst auf Dienstebene vorhanden sein. Beispiel: "site:Redmond" (für den Standort) oder "PstnGateway:Redmond.litwareinc.com" (für den Dienst). |
Instance |
Optional |
TrunkConfiguration |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. Dieser Parameter erfordert ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration", das mit dem Cmdlet Get-CsTrunkConfiguration abgerufen werden kann. |
ConcentratedTopology |
Optional |
Boolescher Wert |
Der Wert dieses Parameters bestimmt, ob ein bekannter Medienendpunkt vorhanden ist. (Ein Beispiel für einen bekannten Medienendpunkt ist ein PSTN-Gateway, bei dem der Medienendpunkt die gleiche IP-Adresse hat wie der Signaldatenverkehr-Endpunkt.) Legen Sie diesen Wert auf "False" fest, wenn der Trunk nicht über einen bekannten Medienendpunkt verfügt. Standard: True |
Description |
Optional |
Zeichenfolge |
Eine Zeichenfolge, mit der der Zweck der Trunkkonfiguration beschrieben wird. |
EnableBypass |
Optional |
Boolescher Wert |
Der Wert dieses Parameters bestimmt, ob die Medienumgehung für diesen Trunk aktiviert ist. Legen Sie diesen Wert auf "True" fest, um die Umgehung zu aktivieren. Beachten Sie, dass zur ordnungsgemäßen Funktion der Medienumgehung bestimmte Funktionen von PSTN-Gateways, SBCs (Session Border Controller) und Nebenstellenanlagen unterstützt werden müssen: - Die Fähigkeit, gegabelte Antworten auf Einladungen zu empfangen. - Lync Server 2010-Clients und der Medienendpunkt müssen direkt und ohne einen Vermittlungsserver miteinander kommunizieren können. - Das Gatewaysubnetz muss für den gleichen Standort wie das Subnetz des Clients definiert sein; ist dies nicht der Fall, dürfen die Standorte nicht durch WAN-Verbindungen mit beschränkter Bandbreite voneinander getrennt sein. Die Medienumgehung kann nur unter den folgenden Umständen aktiviert werden: - Der Parameter "ConcentratedTopology" ist auf "True" festgelegt. - Der Parameter "EnableReferSupport" ist auf "False" festgelegt, und die Werte für "RTCPActiveCalls" und "RTCPCallsOnHold" lauten "False", oder "EnableReferSupport" ist auf "True" festgelegt. Beachten Sie Folgendes: Wenn "EnableBypass" auf "True" und "EnableReferSupport" auf "False" festgelegt wird, wird für nachfolgend weitergeleitete Anrufe mit Medienumgehung keine Medienumgehung durchgeführt. Die Medienumgehung funktioniert nur dann für einen bestimmten Trunk, wenn sie sowohl global als auch für den betreffenden Trunk aktiviert wurde. Verwenden Sie das Cmdlet New-CsNetworkMediaBypassConfiguration, um die Medienumgehung auf globaler Ebene zu aktivieren. Standard: False |
EnableMobileTrunkSupport |
Optional |
Boolescher Wert |
Definiert, ob der Dienstanbieter ein Mobilfunkbetreiber ist. Standard: False |
EnablePIDFLOSupport |
Optional |
Boolescher Wert |
Definiert, ob Notrufe mit PIDF-LO (Presence Information Data Format Location Object) über das definierte Gateway weitergeleitet werden. Legen Sie diesen Parameter auf "True" fest, wenn Notrufe an einen zertifizierten Anbieter für die Notrufunterstützung weitergeleitet werden sollen. (Der Standort wird mit dem Anruf übertragen.) Standard: False |
EnableReferSupport |
Optional |
Boolescher Wert |
Definiert, ob dieser Trunk Übergabeanforderungen vom Vermittlungsserver empfangen kann. Die Medienumgehung kann nur unter den folgenden Umständen aktiviert werden: - Der Parameter "ConcentratedTopology" ist auf "True" festgelegt. - Der Parameter "EnableReferSupport" ist auf "False" festgelegt, und die Werte für "RTCPActiveCalls" und "RTCPCallsOnHold" lauten "False", oder "EnableReferSupport" ist auf "True" festgelegt. Beachten Sie Folgendes: Wenn "EnableBypass" auf "True" und "EnableReferSupport" auf "False" festgelegt wird, wird für nachfolgend weitergeleitete Anrufe mit Medienumgehung keine Medienumgehung durchgeführt. Standard: True |
EnableSessionTimer |
Optional |
Boolescher Wert |
Gibt an, ob der Sitzungszeitgeber aktiviert ist. Mithilfe von Sitzungszeitgebern können Sie ermitteln, ob eine bestimmte Sitzung noch immer aktiv ist. Beachten Sie, dass selbst bei einer Festlegung dieses Parameters auf "False" Sitzungszeitgeber gelten können, wenn für die Remoteverbindung Sitzungszeitgeber aktiviert sind. In einem solchen Fall antwortet der Vermittlungsserver auf Prüfpakete von Sitzungszeitgebern der Remoteentität. Standard: False |
EnableSignalBoost |
Optional |
Boolescher Wert |
Wenn dieser Parameter auf "True" festgelegt ist, verstärken das PSTN-Gateway, die IP-Nebenstellenanlage oder der SBC (Session Border Controller) des Dienstanbieters das Audiosignal im VoIP-Datenstrom, der an den Vermittlungsserver oder Microsoft Lync Server 2010-Clients gesendet wird. Ist dieser Wert auf "False" gesetzt, erfolgt die Verstärkung des Audiosignals entweder beim Vermittlungsserver (für Anrufe ohne Umgehung) oder in Lync Server 2010-Clients (für Anrufe mit Umgehung). Standard: False |
MaxEarlyDialogs |
Optional |
Int64 |
Die maximale Anzahl von gegabelten Antworten, die ein PSTN-Gateway, eine IP-Nebenstellenanlage oder ein SBC (Session Border Controller) des Dienstanbieters auf Einladungen empfangen kann, die an den Vermittlungsserver gesendet werden. Standard: 20 |
OutboundTranslationRulesList |
Optional |
PSListModifier |
Eine Auflistung von Regeln für die Telefonnummernübersetzung für Anrufe, die per Ausgangsrouting verarbeitet werden (d. h., sie werden an Nebenstellenanlagen oder PSTN-Ziele geleitet). Diese Liste und diese Regeln können mit diesem Cmdlet direkt geändert werden; es wird jedoch empfohlen, ausgehende Übersetzungsregeln mit dem Cmdlet Set-CsOutboundTranslationRule zu ändern. Mit Set-CsOutboundTranslationRule wird die Regel geändert, und diese Änderungen werden automatisch in die Trunkkonfiguration aufgenommen. Rufen Sie das Cmdlet New-CsOutboundTranslationRule auf, um die Trunkkonfiguration durch Hinzufügen einer neuen ausgehenden Übersetzungsregel zu ändern. Die neue Regel wird der Trunkkonfiguration mit entsprechendem Gültigkeitsbereich hinzugefügt. |
RemovePlusFromUri |
Optional |
Boolescher Wert |
Wenn Sie diesen Parameter auf "True" festlegen, entfernt der Vermittlungsserver vorangestellte Pluszeichen (+) aus den URIs (Unified Resources Identifier), bevor sie an den Dienstanbieter gesendet werden. Standard: False |
RTCPActiveCalls |
Optional |
Boolescher Wert |
Dieser Parameter legt fest, ob für aktive Anrufe RTCP-Pakete vom PSTN-Gateway, von der IP-Nebenstellenanlage oder vom SBC (Session Border Controller) des Dienstanbieters gesendet werden. Ein aktiver Anruf ist in diesem Kontext ein Anruf, bei dem Mediendaten in mindestens eine Richtung übertragen werden dürfen. Wenn "RTCPActiveCalls" auf "True" festgelegt ist, können der Vermittlungsserver oder Lync Server-Client einen Anruf beenden, wenn für mehr als 30 Sekunden keine RTCP-Pakete empfangen werden. Beachten Sie, dass durch die Deaktivierung der Überprüfung auf empfangene RTCP-Pakete für aktive Anrufe in Lync Server-Elementen eine wichtige Sicherheitsprüfung entfällt, um verworfene Peers zu ermitteln. Eine Deaktivierung sollte nur erfolgen, wenn dies erforderlich ist. Standard: True |
RTCPCallsOnHold |
Optional |
Boolescher Wert |
Dieser Parameter legt fest, ob für Anrufe, die in der Warteschleife platziert wurden und für die erwartungsgemäß keine Medienpakete übermittelt werden, weiterhin RTCP-Pakete über den Trunk gesendet werden. Wenn Wartemusik für den Lync Server-Client oder den Trunk aktiviert ist, wird der Anruf als aktiv eingestuft, und diese Eigenschaft wird ignoriert. Verwenden Sie unter diesen Umständen den Parameter "RTCPActiveCalls". Beachten Sie, dass durch die Deaktivierung der Überprüfung auf empfangene RTCP-Pakete für aktive Anrufe in Lync Server-Elementen eine wichtige Sicherheitsprüfung entfällt, um verworfene Peers zu ermitteln. Eine Deaktivierung sollte nur erfolgen, wenn dies erforderlich ist. Standard: True |
SipResponseCodeTranslationRulesList |
Optional |
PSListModifier |
Eine Liste der Übersetzungsregeln für SIP-Antwortcodes, die für die von einem PSTN-Gateway, einer IP-Nebenstellenanlage oder einem SBC (Session Border Controller) des Dienstanbieters empfangenen Antwortcodes gelten. Diese Regeln ermöglichen Administratoren das Zuordnen von SIP-Antwortcodes mit Werten zwischen 400 und 699, die über einen Trunk empfangen wurden, zu neuen, geeigneteren Werten für Lync Server. Sie können diese Liste und zugehörige Regeln direkt mit diesem Cmdlet erstellen. Es wird jedoch empfohlen, die Übersetzungsregeln für SIP-Antwortcodes mit dem Cmdlet New-CsSipResponseCodeTranslationRule zu erstellen. Dieses Cmdlet erstellt die Regel und weist sie der Trunkkonfiguration mit dem übereinstimmenden Bereich zu. |
SRTPMode |
Optional |
SRTPMode |
Der Wert dieses Parameters legt den Umfang der Unterstützung für SRTP zum Schutz von Mediendaten fest, die zwischen dem Vermittlungsserver und dem PSTN-Gateway, der IP-Nebenstellenanlage oder dem SBC (Session Border Controller) des Dienstanbieters übertragen werden. Bei der Medienumgehung muss dieser Wert mit der Einstellung "EncryptionLevel" in der Medienkonfiguration kompatibel sein. Die Medienkonfiguration wird mit den Cmdlets New-CsMediaConfiguration und Set-CsMediaConfiguration festgelegt. Gültige Werte: - Required: Die SRTP-Verschlüsselung muss verwendet werden. - Optional: SRTP wird verwendet, wenn der Dienstanbieter dieses Protokoll unterstützt. - NotSupported: Die SRTP-Verschlüsselung wird nicht unterstützt und daher auch nicht verwendet. Hinweis: "SRTPMode" wird nur verwendet, wenn das Gateway für die Verwendung von TLS (Transport Layer Security) konfiguriert ist. Wenn das Gateway mit dem Transportprotokoll TCP (Transmission Control Protocol) konfiguriert ist, wird "SRTPMode" intern auf "NotSupported" festgelegt. Standard: Required |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
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
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von Trunkkonfigurationsobjekten.
Rückgabetypen
Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration" geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
In diesem Beispiel wird eine Trunkkonfiguration mit dem Identitätswert "site:Redmond" geändert, um die Medienumgehung zu aktivieren. Die Medienumgehung wird aktiviert, indem dem Parameter "EnableBypass" der Wert "$True" zugewiesen wird. Die verbleibenden Eigenschaften für diese Konfiguration behalten ihre jeweiligen Werte.
-------------------------- Beispiel 2 --------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
In diesem Beispiel wird eine ausgehende Übersetzungsregel geändert, die für die Trunkkonfiguration mit dem Identitätswert "site:Redmond" definiert wurde. Beachten Sie, dass für diese Änderung das Cmdlet Set-CsTrunkConfiguration nicht wirklich aufgerufen wird. Änderungen, die mit Set-CsOutboundTranslationRule vorgenommen werden, werden automatisch in die Trunkkonfiguration aufgenommen, deren Identitätswert mit dem Bereich des Identitätswerts der ausgehenden Übersetzungsregel übereinstimmt.
-------------------------- Beispiel 3 --------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
In Beispiel 3 wird "SRTPMode" für alle auf Standortebene definierten Trunkkonfigurationen auf den Wert "Optional" festgelegt. Mit dem Befehl wird zunächst das Cmdlet Get-CsTrunkConfiguration mit dem Parameter "Filter" aufgerufen, um alle Trunkkonfigurationen abzurufen, deren Identitätswert mit "site:" beginnt, d. h. alle Trunkkonfigurationen, die auf Standortebene definiert sind. Diese Auflistung von Konfigurationen wird dann an das Cmdlet Set-CsTrunkConfiguration weitergeleitet, das die Eigenschaft "SRTPMode" der einzelnen Elemente auf "Optional" festlegt.
-------------------------- Beispiel 4 --------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
In Beispiel 4 wird eine Trunkkonfiguration mit dem Identitätswert "site:Redmond" geändert, um die PIDF-LO-Unterstützung zu aktivieren. Der Standardwert für den Parameter "EnablePIDFLOSupport" lautet "False". In diesem Beispiel wurde der Wert auf "True" festgelegt, um die Standortübertragung für Notrufe zu aktivieren. Sie müssen "EnablePIDFLOSupport" auf "True" festlegen, damit Standortinformationen von der Ausgangsroutinganwendung an den Trunk gesendet werden.