New-CsVoiceNormalizationRule
Letztes Änderungsdatum des Themas: 2012-03-26
Erstellt eine neue VoIP-Normalisierungsregel. VoIP-Normalisierungsregeln werden verwendet, um eine Wählanforderung (z. B. das Wählen der Ziffer 9 für den Zugriff auf eine Amtsleitung) in das von Microsoft Lync Server 2010 verwendete E.164-Telefonnummernformat zu konvertieren.
Syntax
New-CsVoiceNormalizationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceNormalizationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet wird eine benannte VoIP-Normalisierungsregel erstellt. Diese Regeln sind ein erforderlicher Teil der Telefonautorisierung und Anrufweiterleitung. Sie definieren die Anforderungen für das Konvertieren (oder Übersetzen) von Nummern aus einem internen Lync Server 2010-Format in ein Standardformat (E.164). Für das Definieren von zu übersetzenden Nummernmustern ist ein Verständnis regulärer Ausdrücke hilfreich.
Die mit diesem Cmdlet erstellten Regeln sind Teil der Wähleinstellungen. Der Zugriff kann nicht nur über das Cmdlet Get-CsVoiceNormalizationRule, sondern auch über die Eigenschaft "NormalizationRules" erfolgen, die bei einem Aufruf des Cmdlets Get-CsDialPlan zurückgegeben wird. Sie können keine Normalisierungsregel erstellen, es sei denn, es ist bereits ein Satz mit Wähleinstellungen vorhanden, dessen Identitätswert dem in der Normalisierungsregel festgelegten Identitätswert entspricht. Sie können beispielsweise keine Normalisierungsregeln mit dem Identitätswert "site:Redmond/RedmondNormalizationRule" erstellen, es sei denn, es ist bereits ein Satz mit Wähleinstellungen für "site:Redmond" vorhanden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsVoiceNormalizationRule 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-CsVoiceNormalizationRule"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eine eindeutige ID für die Regel. Die angegebene Identität muss den Gültigkeitsbereich umfassen, gefolgt von einem Schrägstrich und dem Namen. Beispiel: site:Redmond/Rule1. Dabei steht "site:Redmond" für den Gültigkeitsbereich und "Rule1" für den Namen. Der Namensteil wird automatisch in der Eigenschaft "Name" gespeichert. "Name" und "Identity" können nicht innerhalb desselben Befehls verwendet werden. VoIP-Normalisierungsregeln können auf den folgenden Ebenen erstellt werden: global, Standort, Dienst (nur "Registrar" und "PSTNGateway), Benutzerebene. Vor dem Erstellen einer neuen Regel müssen bereits Wähleinstellungen vorhanden sein, deren Identitätswert dem Bereich der Normalisierungsregel entspricht. (Zum Abrufen einer Liste mit Wähleinstellungen rufen Sie das Cmdlet Get-CsDialPlan auf.) Der Parameter "Identity" ist nur dann nicht erforderlich, wenn der Parameter "Parent" angegeben wird. Sie können den Parameter "Identity" und den Parameter "Parent" nicht innerhalb desselben Befehls verwenden. |
Name |
Erforderlich |
Zeichenfolge |
Der Name der Regel. Dieser Parameter ist erforderlich, wenn für den Parameter "Parent" ein Wert angegeben wurde. Wenn für den Parameter "Parent" kein Wert angegeben wurde, wird für "Name" standardmäßig der im Parameter "Identity" angegebene Wert verwendet. Beispiel: Beim Erstellen einer Regel mit dem Identitätswert "site:Redmond/RedmondRule" lautet der Name standardmäßig "RedmondRule". Die Parameter "Name" und "Identity" können nicht innerhalb desselben Befehls verwendet werden. |
Parent |
Erforderlich |
Zeichenfolge |
Der Gültigkeitsbereich für die neue Normalisierungsregel. Dieser Wert muss "global; site:<Standortname>" lauten, wobei <Standortname> für den Namen des Lync Server-Standorts, PSTN-Gateways oder Registrierungsdiensts (beispielsweise "PSTNGateway:redmond.litwareinc.com") oder für eine Zeichenfolge steht, die eine benutzerbasierte Regel angibt. Es muss bereits ein Satz mit Wähleinstellungen und dem festgelegten Gültigkeitsbereich vorhanden sein, andernfalls tritt beim Ausführen des Befehls ein Fehler auf. Der Parameter "Parent" ist nur dann nicht erforderlich, wenn der Parameter "Identity" angegeben wird. Sie können den Parameter "Identity" und den Parameter "Parent" nicht innerhalb desselben Befehls verwenden. Wenn Sie den Parameter "Parent" verwenden, ist der Parameter "Name" ebenfalls erforderlich. |
Description |
Optional |
Zeichenfolge |
Eine benutzerfreundliche Beschreibung der Normalisierungsregel. Maximale Länge der Zeichenfolge: 512 Zeichen. |
IsInternalExtension |
Optional |
Boolescher Wert |
Wenn "True" festgelegt wurde, ist das Ergebnis der Anwendung dieser Regel eine organisationsinterne Nummer. Wenn Sie "False" festlegen, ist das Ergebnis eine externe Nummer. Dieser Wert wird ignoriert, wenn der Wert der Eigenschaft "OptimizeDeviceDialing" der zugeordneten Wähleinstellungen auf "False" festgelegt ist. Standard: False |
Pattern |
Optional |
Zeichenfolge |
Ein regulärer Ausdruck, mit dem die gewählte Nummer übereinstimmen muss, damit diese Regel angewendet wird. Standard: ^(\d{11})$ (Der Standardwert steht für eine beliebige Gruppe von Zahlen mit bis zu 11 Zahlen.) |
Priority |
Optional |
Int32 |
Die Reihenfolge, in der Regeln angewendet werden. Eine Telefonnummer kann mit mehreren Regeln übereinstimmen. Dieser Parameter legt die Reihenfolge fest, in der die Regeln mit der Telefonnummer abgeglichen werden. |
Translation |
Optional |
Zeichenfolge |
Das Muster für reguläre Ausdrücke, das zur Konvertierung in das E.164-Format auf die Nummer angewendet wird. Standard: +$1. (Mit dem Standardwert wird der Nummer ein Pluszeichen [+] als Präfix vorangestellt.) |
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.Policy.Voice.NormalizationRule" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
New-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond"
In diesem Beispiel wird eine neue VoIP-Normalisierungsregel für den Standort "Redmond" mit dem Namen "Prefix Redmond" erstellt. Da keine weiteren Parameter angegeben wurden, 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 gesetzt werden.
Beachten Sie außerdem, dass ein Satz mit Wähleinstellungen für den Standort "Redmond" vorhanden sein muss, damit dieser Befehl erfolgreich ausgeführt werden kann. Sie können einen neuen Satz mit Wähleinstellungen erstellen, indem Sie das Cmdlet New-CsDialPlan aufrufen.
-------------------------- Beispiel 2 --------------------------
New-CsVoiceNormalizationRule -Parent SeattleUser -Name SeattleFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1206555$1'
In diesem Beispiel wird eine neue VoIP-Normalisierungsregel mit dem Namen "SeattleFourDigit" erstellt, die für den benutzerbasierten Satz mit Wähleinstellungen mit dem Identitätswert "SeattleUser" gilt. (Hinweis: Zum Erstellen dieser Regel hätte anstelle von Werten für "Parent" und "Name" auch "-Identity SeattleUser/SeattleFourDigit" angegeben werden werden können.) Es wurde eine Beschreibung hinzugefügt, die angibt, dass diese Regel zum Übersetzen von Nummern dient, die intern und ausschließlich unter Verwendung einer vierstelligen Durchwahl gewählt werden. Darüber hinaus wurden Werte für "Pattern" und "Translation" angegeben. Mithilfe dieser Werte wird eine vierstellige Nummer (angegeben durch den regulären Ausdruck in "Pattern") in dieselbe vierstellige Nummer übersetzt, der Wert von "Translation" (+1206555) wird jedoch als Präfix hinzugefügt. Wenn beispielsweise die Durchwahl "1234" eingegeben wird, wird diese Durchwahl mit dieser Regel in die Nummer "+12065551234" übersetzt.
Beachten Sie die einfachen Anführungszeichen um Muster und Übersetzungswerte. Für diese Werte sind einfache Anführungszeichen erforderlich, doppelte Anführungszeichen können in diesem Fall nicht verwendet werden.
Wie in Beispiel 1 muss ein Satz mit Wähleinstellungen mit dem festgelegten Gültigkeitsbereich vorhanden sein. In diesem Fall bedeutet dies, dass bereits ein Satz mit Wähleinstellungen mit dem Identitätswert "SeattleUser" vorhanden sein muss.