• Artikel

Test-CsVoiceNormalizationRule

 

Letztes Änderungsdatum des Themas: 2012-03-27

Testet eine VoIP-Normalisierungsregel für eine Telefonnummer und gibt die Nummer nach Anwendung der Normalisierungsregel zurück. 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

Test-CsVoiceNormalizationRule -DialedNumber <PhoneNumber> -NormalizationRule <NormalizationRule>

Detaillierte Beschreibung

Über dieses Cmdlet können die Ergebnisse der Anwendung einer VoIP-Normalisierungsregel auf eine bestimmte Telefonnummer angezeigt werden. VoIP-Normalisierungsregeln sind ein erforderlicher Teil der Telefonautorisierung und Anrufweiterleitung. Sie definieren die Anforderungen für das Umwandeln (oder Übersetzen) von Nummern von einem typischen Benutzereingabeformat in ein Standardformat (E.164). Mit diesem Cmdlet können Sie Wählprobleme beheben oder überprüfen, ob die Regeln bei bestimmten Nummern erwartungsgemäß funktionieren.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsVoiceNormalizationRule lokal auszufü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 "Test-CsVoiceNormalizationRule"}

Parameter

Parameter Erforderlich Typ Beschreibung

DialedNumber

Erforderlich

PhoneNumber

Die Telefonnummer, für die die im Parameter "NormalizationRule" angegebene Normalisierungsregel getestet werden soll.

Vollständiger Datentyp: Microsoft.Rtc.Management.Voice.PhoneNumber

NormalizationRule

Erforderlich

NormalizationRule

Ein Objekt mit einer Referenz zu der Normalisierungsregel, die für die im Parameter "DialedNumber" angegebene Nummer getestet werden sollen.

Die VoIP-Normalisierungsregeln können mit dem Cmdlet Get-CsVoiceNormalizationRule abgerufen werden.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Normalisierungsregelobjekten.

Rückgabetypen

Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.NormalizationRuleTestResult" zurück.

Beispiel

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

Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule" | Test-CsVoiceNormalizationRule -DialedNumber 14255559999

In diesem Beispiel wird ein VoIP-Normalisierungstest für die VoIP-Normalisierungsregel mit der Identität "global/11 digit number rule" ausgeführt. Zunächst wird das Cmdlet Get-CsVoiceNormalizationRule ausgeführt, um die Regel mit dem Identitätswert "global/11 digit number rule" abzurufen. Dieses Regelobjekt wird anschließend an das Cmdlet Test-CsVoiceNormalizationRule weitergeleitet, das die Regel für die Telefonnummer 14255559999 testet. Die Ausgabe entspricht "DialedNumber", nachdem die VoIP-Normalisierungsregel "global/11 digit number rule" angewendet wurde. Wird diese Regel nicht auf den Wert "DialedNumber" angewendet (wenn die Normalisierungsregel z. B. mit dem Muster für eine elfstellige Nummer übereinstimmt und Sie eine siebenstellige Nummer angeben), wird kein Wert zurückgegeben.

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

$a = Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule"
Test-CsVoiceNormalizationRule -DialedNumber 5551212 -NormalizationRule $a

Beispiel 2 ist mit Beispiel 1 identisch. Der einzige Unterschied ist, dass die Ergebnisse der Get-Operation nicht direkt an das Cmdlet "Test" weitergeleitet werden. Stattdessen wird das Objekt zunächst in der Variablen "$a" gespeichert und anschließend zur Verwendung als Wert für den Parameter "NormalizationRule" übergeben, der als VoIP-Normalisierungsregel verwendet wird, für die der Test ausgeführt wird.

-------------------------- Beispiel 3 --------------------------

Get-CsVoiceNormalizationRule | Test-CsVoiceNormalizationRule -DialedNumber 2065559999

In diesem Beispiel wird ein VoIP-Normalisierungstest für sämtliche VoIP-Normalisierungsregeln ausgeführt, die innerhalb der Lync Server 2010-Bereitstellung definiert sind. Zunächst wird das Cmdlet Get-CsVoiceNormalizationRule ohne Parameter ausgeführt, um alle VoIP-Normalisierungsregeln abzurufen. Die zurückgegebene Auflistung von Regeln wird anschließend an das Cmdlet Test-CsVoiceNormalizationRule weitergeleitet, das jede Regel in der Auflistung für die Telefonnummer 2065559999 testet. Das Ergebnis ist eine Liste übersetzter Nummern (eine pro getesteter Regel). Wird eine Regel nicht auf den Wert "DialedNumber" angewendet (wenn die Normalisierungsregel z. B. mit dem Muster für eine elfstellige Nummer übereinstimmt und Sie eine siebenstellige Nummer angeben), wird in der Liste eine leere Zeile für diese Regel angezeigt.