• Artikel

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.