Set-CsVoiceNormalizationRule
Letztes Änderungsdatum des Themas: 2012-03-27
Ändert eine 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
Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceNormalizationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Dieses Cmdlet ändert eine benannte VoIP-Normalisierungsregel. 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 geänderten 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.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-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 "Set-CsVoiceNormalizationRule"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eine eindeutige ID für die Regel. Die angegebene Identität muss den Gültigkeitsbereich umfassen, auf den ein Schrägstrich und anschließend der Name folgt. Beispiel: site:Redmond/Rule1. Dabei steht "site:Redmond" für den Gültigkeitsbereich und "Rule1" für den Namen. |
Instance |
Optional |
NormalizationRule |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. Dieses Objekt muss vom Typ "NormalizationRule" sein und kann mithilfe von Get-CsVoiceNormalizationRule abgerufen werden. |
Description |
Optional |
Zeichenfolge |
Eine benutzerfreundliche Beschreibung der Normalisierungsregel. Maximale Länge der Zeichenfolge: 512 Zeichen. |
IsInternalExtension |
Optional |
Boolescher Wert |
Bei Festlegung von "True" ist das Ergebnis beim Anwenden dieser Regel eine interne Nummer des Unternehmens. 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. |
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. |
Pattern |
Optional |
Zeichenfolge |
Ein regulärer Ausdruck, mit dem die gewählte Nummer übereinstimmen muss, damit diese Regel angewendet wird. |
Translation |
Optional |
Zeichenfolge |
Das Muster für reguläre Ausdrücke, das zur Konvertierung in das E.164-Format auf die Nummer angewendet wird. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
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.Policy.Voice.NormalizationRule-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Normalisierungsregelobjekten.
Rückgabetypen
Set-CsVoiceNormalizationRule gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"
In diesem Beispiel wird "Add a prefix to all numbers on site Redmond" als Beschreibung der Regel "Prefix Redmond" für den Standort "Redmond" festgelegt.
-------------------------- Beispiel 2 --------------------------
Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'
In diesem Beispiel wird die VoIP-Normalisierungsregel mit der Identität "global/SeattleFourDigit" geändert. Eine neue Beschreibung wird angegeben, in der die Änderungen an der Regel vermerkt sind. Darüber hinaus wird die Regel um einen "Translation"-Wert erweitert. Durch diesen Wert werden Nummern, die mit dem vorhandenen Muster dieser Regel übereinstimmen, um das Präfix "+1206556" ergänzt. Wenn das vorhandene Muster z. B. bei vierstelligen Nummern zu einer Übereinstimmung führt und die Ziffern "1234" eingegeben werden, wird diese Durchwahl in die Nummer "+12065561234" übersetzt.
-------------------------- Beispiel 3 --------------------------
$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a
In Beispiel 3 wird der Name der Normalisierungsregel geändert. Beachten Sie, dass durch die Namensänderung auch der Abschnitt für den Namen in der Identität geändert wird. Da das Cmdlet Set-CsVoiceNormalizationRule nicht über einen Parameter "Name" verfügt, rufen wir zum Ändern des Namens zunächst Get-CsVoiceNormalizationRule auf, um die Regel mit der Identität "global/RedmondFourDigit" abzurufen und das zurückgegebene Objekt der Variablen "$a" zuzuweisen. Anschließend weisen wir der Eigenschaft "Name" des Objekts die Zeichenfolge "RedmondRule" zu. Dann übergeben wir die Variable an den Parameter "Instance" des Cmdlets Set-CsVoiceNormalizationRule, um die Änderung dauerhaft zu speichern.