Get-CsVoiceNormalizationRule
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den in Ihrer Organisation verwendeten VoIP-Normalisierungsregeln zurück. VoIP-Normalisierungsregeln werden verwendet, um Wählanforderungen (z. B. das Wählen der Ziffer 0 für den Zugriff auf eine Amtsleitung) in das von Microsoft Lync Server 2010 verwendete E.164-Telefonnummernformat zu konvertieren.
Syntax
Get-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceNormalizationRule [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Über dieses Cmdlet wird eine benannte VoIP-Normalisierungsregel oder eine Sammlung von VoIP-Normalisierungsregeln zurückgegeben. Diese Regeln sind ein erforderlicher Teil der Telefonautorisierung und Anrufweiterleitung. Sie definieren die Anforderungen für das Umwandeln (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.
Der Zugriff auf die Regeln, auf die mit diesem Cmdlet zugegriffen wird, kann auch über die Eigenschaft "NormalizationRules" erfolgen, die beim 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 Get-CsVoiceNormalizationRule lokal ausfü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-CsVoiceNormalizationRule"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eine eindeutige ID für die Regel. Wenn für diesen Parameter ein Wert angegeben wird, muss er mit dem Format "Gültigkeitsbereich/Name" angegeben werden, z. B.: "site:Redmond/Rule1". Dabei steht "site:Redmond" für den Gültigkeitsbereich und "Rule1" für den Namen. |
Filter |
Optional |
XdsIdentityFilter |
Verwendet Platzhalterzeichenfolgen, um eine Auflistung von Normalisierungsregeln basierend auf der Identität zurückzugeben. Beachten Sie, dass der Filter nur auf den Abschnitt zum Gültigkeitsbereich der Identität, nicht jedoch auf den Namen angewendet wird. Der Filterwert "*lob*" gibt z. B. alle Regeln auf globaler Ebene (welche die Zeichenfolge "lob" enthalten), nicht jedoch Regeln mit der Identität "site:Redmond/lobby" zurück, wobei "lob" nur der Namensteil der Identität, nicht der Gültigkeitsbereich ist. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die VoIP-Normalisierungsregel aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine.
Rückgabetypen
Mit dem Cmdlet Get-CsVoiceNormalizationRule werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsVoiceNormalizationRule
In diesem Beispiel werden alle für die Organisation definierten VoIP-Normalisierungsregeln abgerufen.
-------------------------- Beispiel 2 --------------------------
Get-CsVoiceNormalizationRule -Filter site*
In Beispiel 2 werden alle VoIP-Normalisierungsregeln abgerufen, die für sämtliche Standorte definiert sind.
-------------------------- Beispiel 3 --------------------------
Get-CsVoiceNormalizationRule -Filter *s*
Beispiel 3 ruft alle VoIP-Normalisierungsregeln mit dem Buchstaben "s" irgendwo im Gültigkeitsbereich ab. Dieser Befehl gibt beispielsweise alle Regeln auf Standort- und Dienstebene sowie benutzerbezogene Regeln mit einem "s" im Gültigkeitsbereichsnamen zurück, z. B. "RedmondEastUsers".
-------------------------- Beispiel 4 --------------------------
Get-CsVoiceNormalizationRule | Where-Object {$_.Name -match "seattle"}
Der in den Beispielen 2 und 3 verwendete Parameter "Filter" ermittelt lediglich Übereinstimmungen für den Gültigkeitsbereich der Identität. In diesem Beispiel werden Übereinstimmungen im Namen ermittelt, um alle Regeln zurückzugeben, deren Namen die Zeichenfolge "seattle" enthalten. Zu diesem Zweck wird zunächst Get-CsVoiceNormalizationRule aufgerufen, um alle Normalisierungsregeln für die Organisation abzurufen. Anschließend wird die ermittelte Auflistung an das Cmdlet Where-Object weitergeleitet, um alle Elemente in der Auflistung zu ermitteln, deren Eigenschaft "Name" mit der Zeichenfolge "seattle" übereinstimmt.
Siehe auch
Weitere Ressourcen
New-CsVoiceNormalizationRule
Remove-CsVoiceNormalizationRule
Set-CsVoiceNormalizationRule
Test-CsVoiceNormalizationRule
Get-CsDialPlan