• Artikel

New-CsVoiceRegex

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt ein Muster für reguläre Ausdrücke und eine Übersetzung von Telefonnummern in verschiedene Formate.

Syntax

New-CsVoiceRegex -AtLeastLength <Int32> [-DigitsToPrepend <String>] [-DigitsToStrip <Int32>] [-StartsWith <String>]

New-CsVoiceRegex -ExactLength <Int32> [-DigitsToPrepend <String>] [-DigitsToStrip <Int32>] [-StartsWith <String>]

Detaillierte Beschreibung

Reguläre Ausdrücke werden für die Entsprechung von Zeichenmustern verwendet. In Microsoft Lync Server 2010 werden reguläre Ausdrücke verwendet, um Telefonnummern in verschiedene Formate und aus verschiedenen Formaten zu konvertieren, einschließlich gewählter Nummern, des E.164-Formats sowie der Formate für Nebenstellenanlagen (Private Branch Exchange, PBX) und Telefonfestnetze (Public Switched Telephone Network, PSTN). Das Definieren dieser Konvertierungsregeln kann verwirrend sein, wenn Sie die Syntax- und Formatregeln zum Arbeiten mit regulären Ausdrücken nicht kennen. Das Cmdlet New-CsVoiceRegex stellt Parameter bereit, mit denen Sie bestimmte Kriterien festlegen können, und generiert den regulären Ausdruck für Sie.

Verwenden Sie dieses Cmdlet, um reguläre Ausdrücke zu generieren, die für die Werte "Pattern" und "Translation" für Normalisierungsregeln (New-CsVoiceNormalizationRule) und ausgehende Übersetzungsregeln (New-CsOutboundTranslationRule) sowie für den Wert "NumberPattern" für VoIP-Routen (New-CsVoiceRoute) verwendet werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

AtLeastLength

Erforderlich

Int32

Die Mindestlänge, die für die Zeichenfolge (Telefonnummer) erforderlich ist, die mit dem Ausdruck übereinstimmt. Wenn Sie z. B. eine sich nur auf Zahlen auswirkende Normalisierungsregel definieren, die mindestens 7 Ziffern (oder Zeichen) lang sein muss, legen Sie den Wert 7 für diesen Parameter fest.

Sie müssen entweder für diesen Parameter oder für den Parameter "ExactLength" einen Wert eingeben. Sie können nicht für beide Parameter einen Wert eingeben.

ExactLength

Erforderlich

Int32

Die Länge der Zeichenfolge (Telefonnummer), die mit dem regulären Ausdruck übereinstimmen muss. Wenn sich beispielsweise eine Normalisierungsregel nur auf Zahlen mit 10 Ziffern auswirken soll, legen Sie den Wert 10 für diesen Parameter fest.

Sie müssen entweder für diesen Parameter oder für den Parameter "AtLeastLength" einen Wert eingeben. Sie können nicht für beide Parameter einen Wert eingeben.

DigitsToPrepend

Optional

Zeichenfolge

Eine Zeichenfolge, mit der die Zeichen oder Zahlen festgelegt werden, die der Telefonnummer vorangestellt werden. Der in diesen Parameter eingegebene Wert wirkt sich auf den Wert "Translation" aus, indem Zeichen der Nummer vorangestellt werden, die mit dem Muster für reguläre Ausdrücke übereinstimmt. Wenn z. B. die mit dem Muster übereinstimmende Nummer 5551212 und der Wert "DigitsToPrepend" 425 lautet, lautet die übersetzte Nummer 4255551212 (vorausgesetzt, es wurden keine weiteren Übersetzungen angewendet).

DigitsToStrip

Optional

Int32

Die Anzahl der Zeichen, die von der Zeichenfolge (Telefonnummer) entfernt werden. Wenn z. B. die Nummer 2065551212 eingegeben wird und der Wert "DigitsToStrip" 3 lautet, wird die Nummer in 5551212 übersetzt.

StartsWith

Optional

Zeichenfolge

Das erste Zeichen der Zeichenfolge (Telefonnummer). Die Zeichenfolge stimmt nicht mit dem regulären Ausdruck überein, es sein denn, sie beginnt mit der Zeichenfolge, die im Parameter "StartsWith" festgelegt wurde. Wenn z. B. der Wert +1 für "StartsWith" festgelegt wurde, stimmen nur die Zahlen diesem Muster überein, die mit +1 beginnen, und nur diese Zahlen werden übersetzt. Beachten Sie, dass die Anzahl von Zeichen in der Zeichenfolge "StartsWith" in der Gesamtanzahl von "ExactLength" und "AtLeastLength" enthalten ist. Wenn Sie z. B. für "ExactLength" den Wert 10 und für die Zeichenfolge "StartWith" den Wert +1 festgelegt haben, ist eine übereinstimmende Telefonnummer 8 Zeichen lang. Dieser Nummer ist +1 vorangestellt, und sie ist insgesamt 10 Zeichen lang.

Eingabetypen

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.OcsVoiceRegex".

Beispiel

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

$regex = New-CsVoiceRegex -ExactLength 7 -DigitsToStrip 3

In diesem Beispiel wird ein neues Muster für reguläre Ausdrücke und eine neue Übersetzung erstellt. Dieser Ausdruck enthält ein Muster, das genau 7 Zeichen (-ExactLength 7) lang sein muss. Die ersten drei Zeichen der übereinstimmenden Nummer (-DigitsToStrip 3) werden entfernt. Der durch diesen regulären Ausdruck erstellte Wert "Pattern" lautet ^\d{3}(\d{4})$, wohingegen der Wert "Translation" auf "$1" festgelegt ist. Die Nummer 5551212 stimmt z. B. mit diesem Muster überein, und die Übersetzung würde 1212 lauten: die 7-stellige Nummer ohne die ersten 3 Ziffern.

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

$regex = New-CsVoiceRegex -AtLeastLength 7 -StartsWith "1"
New-CsVoiceNormalizationRule "global/internal rule" -Pattern $regex.Pattern -Translation $regex.Translation

In diesem Beispiel wird ein neues Muster für reguläre Ausdrücke und eine neue Übersetzung erstellt. Es werden jedoch diese Werte verwendet, um eine neue VoIP-Normalisierungsregel zu erstellen. In der ersten Zeile wird New-CsVoiceRegExaufgerufen, um einen regulären Ausdruck zu erstellen, bei dem die übereinstimmende Zahl mindestens 7 Zeichen (-AtLeastLength 7) lang sein und mit einer 1 (-StartsWith "1") beginnen muss. Das Ergebnis dieses Befehls wird der Variablen "$regex" zugewiesen.

In der zweiten Zeile wird das Cmdlet New-CsVoiceNormalizationRule aufgerufen. Die neue Regel erhält einen eindeutigen Namen, in diesem Fall "globale/interne Regel". Der Wert "Pattern" wird als Wert "Pattern" der Normalisierungsregel zugewiesen, der mit dem Aufruf von New-CsVoiceRegex erstellt wurde: -Pattern $regex.Pattern. Dies wird auch für den Wert "Translation" durchgeführt, indem der Wert "Translation" zugewiesen wird. Dieser Wert wurde durch den Aufruf von New-CsVoiceRegex erstellt: -Translation $regex.Translation.

Hinweis: Der in diesem Beispiel erstellte Wert "Pattern" lautet ^(1\d{5}\d+)$. Dieser Wert kann als Nummer entziffert werden, die mit 1 (1) beginnt, gefolgt von fünf Ziffern (\d{5}) und einer beliebigen Anzahl von Ziffern (\d+). Dies ergibt eine Nummer mit mindestens 7 Ziffern (1 plus 5 plus 1 oder mehr Ziffern), die wie gewünscht mit 1 beginnen.