• Artikel

Get-CsOutboundTranslationRule

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere ausgehende Übersetzungsregeln ab. Eine ausgehende Übersetzungsregel konvertiert Telefonnummern in das lokale Wählformat, um die Interaktion mit Nebenstellenanlagen (Private Branch Exchange, PBX) und PSTN-Gateways (Public Switched Telephone Network) zu ermöglichen.

Syntax

Get-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsOutboundTranslationRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Rufen Sie dieses Cmdlet auf, um eine bestehende ausgehende Übersetzungsregel abzurufen. Microsoft Lync Server 2010 normalisiert Telefonnummern in das E.164-Format. Viele Nebenstellenanlagen können dieses Format allerdings nicht verarbeiten. Ausgehende Übersetzungsregeln übersetzen die Nummer in das lokale Wählformat, bevor sie diese an den Vermittlungsserver oder an das Gateway senden.

Jede ausgehende Übersetzungsregel ist einer Trunkkonfiguration zugeordnet. Es ist möglich, jeder Trunkkonfiguration mehrere ausgehende Übersetzungsregeln zuzuordnen. Der Identitätswert jeder Regel besteht daher aus einem Gültigkeitsbereich und einem innerhalb des Gültigkeitsbereichs eindeutigen Namen (im Format "Gültigkeitsbereich/Name", z. B. "site:Redmond/OBR1"). Die Regel wird automatisch der Trunkkonfiguration im gleichen Gültigkeitsbereich zugeordnet.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die ausgehende Übersetzungsregel, die abgerufen werden soll. Der Identitätswert besteht aus dem Gültigkeitsbereich, gefolgt von einem eindeutigen Namen in jedem Gültigkeitsbereich (z. B. "site:Redmond/OutboundRule1"). Durch Angeben eines Identitätswerts wird maximal eine ausgehende Übersetzungsregel zurückgegeben.

Filter

Optional

Zeichenfolge

Führt eine Platzhaltersuche anhand des Identitätswerts aus, mit der die Ergebnisse auf die ausgehenden Übersetzungsregeln beschränkt werden können, deren Identitätswerte mit der angegebenen Platzhaltersuchzeichenfolge übereinstimmen.

LocalStore

Optional

Switch-Parameter

Ruft die ausgehende Übersetzungsrichtlinie aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit diesem Cmdlet werden ein oder mehrere Objekte vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule" abgerufen.

Beispiel

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

Get-CsOutboundTranslationRule

In diesem Beispiel werden alle ausgehenden Übersetzungsregeln für die Lync Server 2010-Bereitstellung abgerufen.

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

Get-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"

In diesem Beispiel wird eine einzelne ausgehende Übersetzungsregel abgerufen: die Regel mit dem Identitätswert "site:Redmond/Prefix Redmond".

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

Get-CsOutboundTranslationRule -Filter site:*

In diesem Beispiel werden alle ausgehenden Übersetzungsregeln auf Standortebene abgerufen. Der Befehl ruft das Cmdlet Get-CsOutboundTranslationRule mit dem Filterwert "site:*" auf, wodurch eine Auflistung aller Regeln zurückgegeben wird, deren Identitätswert mit der Zeichenfolge "site:" beginnt.