Freigeben über

  • Artikel

Remove-CsSipResponseCodeTranslationRule

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine Übersetzungsregel für SIP-Antwortcodes. Diese Regeln ermöglichen Administratoren das Zuordnen von SIP-Antwortcodes mit Werten zwischen 400 und 699 zu den von Microsoft Lync Server 2010 verwendeten Werten.

Syntax

Remove-CsSipResponseCodeTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das SIP-Trunking bietet eine Möglichkeit zur Verbindung eines VoIP-Netzwerks (z. B. Enterprise-VoIP) mit dem Telefonfestnetz (Public Switched Telephone Network, PSTN). In Lync Server 2010 verwendet der Vermittlungsserver Trunkpeers zur Interaktion mit dem Telefonfestnetz. Wenn ein ausgehender Anruf im Telefonfestnetz nicht getätigt werden kann, wird automatisch ein ISUP-Ursachencode (ISDN User Part) generiert. Beispielsweise kann ein PSTN-Gateway den Ursachencode 34 senden, um anzuzeigen, dass keine Verbindung bzw. kein Kanal zum Tätigen des Anrufs verfügbar war. Wenn ein Vermittlungsserver-Trunkpeer diesen ISUP-Ursachencode empfängt, konvertiert er diesen Code in einen SIP-Antwortcode, der anschließend an den Vermittlungsserver selbst gesendet wird. Lync Server wiederum verwendet diese Antwortcodes, um Entscheidungen zum Ausgangsrouting zu treffen. Beispiel: Einem fehlerhaften Gateway wird automatisch der Status "weniger bevorzugt" zugewiesen. Auf diese Weise wird das fehlerhafte Gateway weniger genutzt und gleichzeitig die Chance erhöht, dass ein Anruf erfolgreich getätigt werden kann.

Es verwenden jedoch nicht alle Gateways die empfohlene Zuordnung von ISUP-Ursachencodes zu SIP-Antwortcodes, die von Lync Server genutzt werden. Für diese Gateways können Administratoren mit den CsSipResponseCodeTranslationRule-Cmdlets die Gateway-SIP-Antwortcodes (in Kombination mit dem ISUP-Ursachencode, sofern dieser Code verfügbar ist) einem SIP-Antwortcode zuordnen, der von Lync Server verwendet wird. Beispielsweise ordnet ein Gateway den ISUP-Ursachencode 34 ("Keine Verbindung/kein Kanal verfügbar") möglicherweise dem SIP-Antwortcode 486 zu ("Belegt"). Bei Auftreten von Antwortcode 486 versucht die Lync Server-Logik für das Ausgangsrouting nicht, ein neues Gateway zum Tätigen des Anrufs zu ermitteln.

Für Lync Server sollte SIP-Antwortcode 486 daher stattdessen dem SIP-Antwortcode 503 zugeordnet werden. Bei Antwortcode 503 wird in der Lync Server-Logik für das Ausgangsrouting der Wiederholungsmechanismus ausgelöst, d. h. das System sucht nach einem anderen Gateway zum Tätigen des Anrufs. Um diese Situation zu verhindern, können Sie eine Übersetzungsregel erstellen, welche die Kombination aus ISUP-Ursachencode 34 und SIP-Antwortcode 486 dem SIP-Antwortcode 503 zuordnet.

Mit dem Cmdlet Remove-CsSipResponseCodeTranslationRule können Sie jede zuvor für die Verwendung in Ihrer Organisation konfigurierte Übersetzungsregel löschen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsSipResponseCodeTranslationRule lokal auszufü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 "Remove-CsSipResponseCodeTranslationRule"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu entfernende Übersetzungsregel. Der Identitätswert einer Übersetzungsregel besteht aus zwei Teilen: dem Gültigkeitsbereich, in dem die Regel konfiguriert wurde, und dem Namen, der der Regel bei ihrer Erstellung zugewiesen wurde. Eine Übersetzungsregel mit dem Namen "Rule404", die mit globalem Gültigkeitsbereich erstellt wurde, hat beispielsweise den folgenden Identitätswert: global/Rule404.

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

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated-Objekt. Remove-CsSipResponseCodeTranslationRule akzeptiert weitergeleitete Instanzen des Übersetzungsregelobjekts für SIP-Antwortcodes.

Rückgabetypen

Mit Remove-CsSipResponseCodeTranslationRule werden keine Objekte oder Werte zurückgegeben. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated" gelöscht.

Beispiel

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

Remove-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404"

Der Befehl in Beispiel 1 löscht eine einzelne Übersetzungsregel für SIP-Antwortcodes: die Regel mit dem Identitätswert "PstnGateway:192.168.0.240/Rule404".

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

Get-CsSipResponseCodeTranslationRule -Filter "service:PstnGateway:192.168.0.240/*" | Remove-CsSipResponseTranslationCode

In Beispiel 2 werden alle Übersetzungsregeln für Antwortcodes aus dem PSTN-Gateway 192.168.0.240 entfernt. Hierzu ruft der Befehl zunächst Get-CsSipResponseCodeTranslationRule zusammen mit dem Parameter "Filter" auf. Der Filterwert "service:PstnGateway:192.168.0.240/*" beschränkt die zurückgegebenen Daten auf Regeln, deren Identitätswerte mit der Zeichenfolge "service:PstnGateway:192.168.0.240/" beginnen. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsSipResponseTranslationCode weitergeleitet, das jede Regel in der Auflistung löscht.

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

Get-CsSipResponseCodeTranslationRule | Where-Object {$_.ReceivedISUPCauseValue -eq -1} | Remove-CsSipResponseTranslationCode

Mit dem vorstehenden Befehl werden alle Übersetzungsregeln für SIP-Antwortcodes gelöscht, für die kein Wert für die Eigenschaft "ReceivedISUPCauseValue" konfiguriert ist. Hierzu ruft der Befehl zunächst Get-CsSipResponseCodeTranslationRule ohne Parameter auf, um eine Auflistung aller derzeit verwendeten Übersetzungsregeln für Antwortcodes zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Regeln herausfiltert, bei denen die Eigenschaft "ReceivedISUPCauseValue" den Wert "-1" aufweist.

Die gefilterte Auflistung wird an das Cmdlet Remove-CsSipResponseTranslationCode weitergeleitet, das jede Regel in dieser Auflistung löscht.