• Artikel

New-CsTrunkConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Erstellt eine neue 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

New-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>] [-InMemory <SwitchParameter>] [-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 neue Trunkkonfiguration für PSTN-Gatewayentitäten zu erstellen. 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 New-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 "New-CsTrunkConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID, die den Gültigkeitsbereich der Trunkkonfiguration enthält. Trunkkonfigurationen können auf Standortebene bzw. für einen PSTN-Gatewaydienst auf Dienstebene erstellt werden. (Eine globale Konfiguration ist standardmäßig vorhanden und kann nicht entfernt oder neu erstellt werden.) Beispiel: "site:Redmond" (für den Standort) oder "PstnGateway:Redmond.litwareinc.com" (für den Dienst).

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 über keinen 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 Möglichkeit, gegabelte Antworten auf Einladungen zu empfangen.

- Microsoft 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 Remotesitzung 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 an den Vermittlungsserver gesendete Einladungen empfangen kann.

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).

Wenngleich diese Liste und die Regeln direkt mit diesem Cmdlet erstellt werden können, sollten die ausgehenden Übersetzungsregeln mit dem Cmdlet New-CsOutboundTranslationRule erstellt werden. Dieses Cmdlet erstellt die Regel und weist sie der Trunkkonfiguration mit dem entsprechenden Geltungsbereich zu.

RemovePlusFromUri

Optional

Boolescher Wert

Wenn Sie diesen Parameter auf "True" festlegen, entfernt der Vermittlungsserver vorangestellte Pluszeichen (+) aus den URIs (Unified Resource 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, der IP-Nebenstellenanlage oder dem 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 den von einem PSTN-Gateway, einer IP-Nebenstellenanlage oder einem SBC (Session Border Controller) des Dienstanbieters empfangenen Antwortcodes entsprechen. 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 die Unterstützungsebene 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 es vom Gateway unterstützt wird.

- NotSupported: Die SRTP-Verschlüsselung wird nicht unterstützt und daher auch nicht verwendet.

Hinweis: "SRTPMode" wird nur verwendet, wenn das Gateway zur 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.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration".

Beispiel

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

New-CsTrunkConfiguration -Identity site:Redmond

In diesem Beispiel wird eine neue Trunkkonfiguration mit dem Identitätswert "site:Redmond" erstellt. Die übrigen Eigenschaften für diese neue Konfiguration werden mit Standardwerten aufgefüllt.

-------------------------- Beispiel 2 --------------------------

New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True

In diesem Beispiel wird eine neue Trunkkonfiguration mit dem Identitätswert "site:Redmond" erstellt und die Medienumgehung aktiviert. Die Medienumgehung wird aktiviert, indem dem Parameter "EnableBypass" der Wert "$True" zugewiesen wird. Die übrigen Eigenschaften für diese neue Konfiguration werden mit Standardwerten aufgefüllt.

-------------------------- Beispiel 3 --------------------------

New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'

In diesem Beispiel wird eine neue Trunkkonfiguration mit dem Identitätswert "site:Redmond" erstellt und dem Trunk anschließend eine neue ausgehende Übersetzung zugewiesen. In der ersten Zeile des Beispiels wird New-CsTrunkConfiguration aufgerufen, um die neue Trunkkonfiguration mit Standardeinstellungen zu erstellen. In der zweiten Zeile wird das Cmdlet New-CsOutboundTranslationRule aufgerufen. Beachten Sie den zugewiesenen Identitätswert: site:Redmond/OTR1. Der erste Teil des Identitätswerts (site:Redmond) definiert den Geltungsbereich, auf den die Regel angewendet wird. Dieser Geltungsbereich entspricht dem Identitätswert der neuen Trunkkonfiguration, was bedeutet, dass diese Regel automatisch auf diese Konfiguration angewendet wird. Dem Geltungsbereich folgen ein Schrägstrich (/) und eine Zeichenfolge, bei der es sich lediglich um einen eindeutigen Namen für diese Regel handelt. (Pro Geltungsbereich können mehrere Regeln vorliegen.) Anschließend werden Werte an die Parameter "Pattern" und "Translation" übergeben, die diese Regel definieren.