• Artikel

New-CsOutboundTranslationRule

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue ausgehende Übersetzungsregel. Eine ausgehende Übersetzungsregel konvertiert Telefonnummern in das lokale Wählformat, um die Interaktion mit Nebenstellenanlagen (Private Branch Exchange, PBX) zu ermöglichen.

Syntax

New-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

New-CsOutboundTranslationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Rufen Sie dieses Cmdlet auf, um eine neue ausgehende Übersetzungsregel zu erstellen. 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 Konfiguration 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. Wenn Sie New-CsOutboundTranslationRule aufrufen und einen Gültigkeitsbereich festlegen, für den noch keine Trunkkonfiguration definiert wurde, wird die Trunkkonfiguration mit dem angegebenen Gültigkeitsbereich, der ausgehenden Übersetzungsregel und den Standardwerten erstellt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID für die ausgehende Übersetzungsregel. Der Identitätswert umfasst den Gültigkeitsbereich, für den die Regel gilt, sowie den Namen der Regel. Er muss auf globaler Ebene, Standort- oder Dienstebene (nur PSTNGateway) festgelegt werden. Beispiel: "site:Redmond/OutboundRule1" und "PstnGateway:Redmond.litwareinc.com/OutboundRule2".

Wenn der Parameter "Identity" angegeben ist, können Sie keine Werte für die Parameter "Name" oder "Parent" festlegen.

Parent

Erforderlich

Zeichenfolge

Der Gültigkeitsbereich der ausgehenden Übersetzungsregel. Wenn für diesen Parameter ein Wert festgelegt ist, muss auch für den Parameter "Name" ein Wert festgelegt werden. Der Parameter "Identity" kann jedoch nicht festgelegt werden. Wenn die Parameter "Parent" und "Name" festgelegt werden, muss auch der Identitätswert festgelegt werden.

Name

Erforderlich

Zeichenfolge

Der Name der ausgehenden Übersetzungsregel. Wenn "Name" nicht angegeben wird, muss ein Identitätswert mit einem Gültigkeitsbereich und einem Namen festgelegt werden. Wenn "Name" angegeben wird, muss auch der Parameter "Parent" angegeben werden. Es kann jedoch kein Identitätswert festgelegt werden.

Description

Optional

Zeichenfolge

Eine Beschreibung der ausgehenden Übersetzungsregel. Anhand dieser Beschreibung wird der Zweck der Regel identifiziert.

Pattern

Optional

Zeichenfolge

Ein regulärer Ausdruck, der das Nummernmuster repräsentiert, für das die Übersetzung gilt.

Standard: ^\+(\d*)$

Priority

Optional

Int32

Wenn eine Nummer dem Muster einer oder mehrerer ausgehender Übersetzungsregeln entspricht, werden die Regeln nach ihrer Priorität angewendet. Verwenden Sie diesen Parameter, um der Regel eine Priorität zuzuweisen.

Translation

Optional

Zeichenfolge

Ein regulärer Ausdruck, der auf die mit dem Muster übereinstimmende Nummer angewendet wird, um diese auf das Ausgangsrouting vorzubereiten.

Standard: $1

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

Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule" erstellt.

Beispiel

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

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

In diesem Beispiel wird eine neue ausgehende Übersetzungsregel für den Standort "Redmond" mit dem Namen "Prefix Redmond" erstellt. Da keine weiteren Parameter angegeben werden, wird die Regel mit den Standardwerten erstellt. Beachten Sie, dass der an den Parameter "Identity" übergebene Wert in doppelte Anführungszeichen gesetzt wurde. Der Grund dafür ist, dass der Name der Regel (Prefix Redmond) ein Leerzeichen enthält. Wenn der Regelname keine Leerzeichen enthält, muss der Identitätswert nicht in doppelte Anführungszeichen eingeschlossen werden.

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

New-CsOutboundTranslationRule -Parent global -Name SeattleSevenDigit -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

In diesem Beispiel wird die neue globale ausgehende Übersetzungsregel "SeattleSevenDigit" erstellt. (Hinweis: Zum Erstellen dieser Regel hätte anstelle von Werten für "Parent" und "Name" auch "-Identity global/SeattleSevenDigit" angegeben werden können.) Es ist eine Beschreibung enthalten, die erläutert, dass diese Regel zur Übersetzung von Nummern im E.164-Format in eine siebenstellige Nummer dient. Darüber hinaus wurden Werte für "Pattern" und "Translation" angegeben. Diese Werte übersetzen eine vom regulären Ausdruck im Muster angegebene Nummer im E.164-Format (in diesem Fall 12 Ziffern, die mit +1425 beginnen) durch Entfernen der ersten fünf Ziffern in eine siebenstellige Nummer. Die Nummer +14255551212 wird beispielsweise in 5551212 übersetzt.