• Artikel

Test-CsVoiceRoute

 

Letztes Änderungsdatum des Themas: 2012-03-26

Testet die Übereinstimmung einer Telefonnummer mit dem Nummernmuster der VoIP-Route und gibt einen booleschen Wert ("True"/"False") zurück, der angibt, ob die bereitgestellte Nummer dem Nummernmuster für die Route entspricht. Das Nummernmuster ist nur eine der von VoIP-Routen verwendeten Eigenschaften, anhand derer Microsoft Lync Server 2010 ermittelt, wie Anrufe von Enterprise-VoIP-Benutzern bei Telefonnummern im Telefonfestnetz (Public Switched Telephone Network, PSTN) oder in einer Nebenstellenanlage (Private Branch Exchange, PBX) weitergeleitet werden sollen.

Syntax

Test-CsVoiceRoute -Route <Route> -TargetNumber <PhoneNumber> [-Force <SwitchParameter>]

Detaillierte Beschreibung

Eine VoIP-Route umfasst einen regulären Ausdruck, der festlegt, welche Telefonnummern über eine vorgegebene VoIP-Route weitergeleitet werden: Alle Telefonnummern, die mit dem regulären Ausdruck übereinstimmen, werden über diese Route weitergeleitet. Mit diesem Cmdlet wird basierend auf dem Nummernmuster der Route (der Eigenschaft "NumberPattern") überprüft, ob eine bestimmte Telefonnummer über eine angegebene VoIP-Route weitergeleitet wird. Sie können dieses Cmdlet für die Behebung von Routingproblemen sowie für das Testen von Telefonnummern für bestimmte Routen verwenden, um sicherzustellen, dass die Ergebnisse Ihren Erwartungen entsprechen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Test-CsVoiceRoute 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 "Test-CsVoiceRoute"}

Parameter

Parameter Erforderlich Typ Beschreibung

Route

Erforderlich

Route

Ein Objekt mit einem Verweis auf die VoIP-Route, die für die im Parameter "TargetNumber" angegebene Nummer getestet werden soll. Sie können ein VoIP-Routenobjekt mit dem Cmdlet Get-CsVoiceRoute abrufen.

Vollständiger Datentyp: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route

TargetNumber

Erforderlich

PhoneNumber

Die Telefonnummer, für welche die im Parameter "Route" angegebene VoIP-Route getestet werden soll. Diese Nummer muss im E.164-Format vorliegen (z. B. +14255551212).

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

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Bestätigungsaufforderungen oder Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Cmdlets auftreten können.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Routenobjekten.

Rückgabetypen

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

Beispiel

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

$vr = Get-CsVoiceRoute -Identity testroute
Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $vr

Mit diesem Befehl wird bestimmt, ob eine Nummer mit dem Muster für eine angegebene Route übereinstimmt. Zunächst wird mit dem Cmdlet Get-CsVoiceRoute die VoIP-Route "testroute" abgerufen. Diese Route wird als Wert für den Parameter "Route" des Cmdlets Test-CsVoiceRoute verwendet. Darüber hinaus wird die zu testende Nummer im Parameter "TargetNumber" angegeben. Die Ausgabe ist ein boolescher Wert, der angibt, ob die Zielnummer dem Muster für diese Route übereinstimmt.

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

Get-CsVoiceRoute -Identity testroute | Test-CsVoiceRoute -TargetNumber "+14255551212"

Mit dem Befehl in Beispiel 2 wird dieselbe Aktion wie in Beispiel 1 ausgeführt. In diesem Beispiel wird hierfür jedoch nur ein Befehl verwendet. Zunächst wird das Cmdlet Get-CsVoiceRoute aufgerufen, um die VoIP-Route mit dem Identitätswert "testroute" abzurufen. Anschließend wird diese VoIP-Route an das Cmdlet Test-CsVoiceRoute weitergeleitet, und die Route wird mit der im Parameter "TargetNumber" angegebenen Nummer abgeglichen. Beachten Sie, dass der Parameter "Route" nicht angegeben werden muss, da die Route an das Cmdlet weitergeleitet wurde.

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

Get-CsVoiceRoute | Test-CsVoiceRoute -TargetNumber "+14255551212"

In diesem Beispiel wird eine Auflistung aller VoIP-Routen abgerufen, die in einer Lync Server 2010-Bereitstellung definiert wurden, und die Nummernmuster jeder Route werden mit der im Aufruf des Cmdlets Test-CsVoiceRoute angegebenen "TargetNumber" abgeglichen. Die Ausgabe enthält für jede getestete Route den Wert "True" oder "False".

-------------------------- Beispiel 4 --------------------------

$z = Get-CsVoiceRoute
foreach ($x in $z){$x.Identity; Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $x}

Dieses Beispiel ähnelt Beispiel 3, da hier die Ergebnisse eines VoIP-Routentests für mehrere Routen abgerufen werden. Die Ausgabe in Beispiel 3 besteht jedoch lediglich aus einer Liste von True/False-Werten ohne eindeutige Angabe, für welche Route die Testergebnisse gelten. In diesem Beispiel wird dieses Problem gelöst. (Die Ausgabe ist zwar verbesserungsfähig, dieses kurze Beispiel führt jedoch zumindest zum gewünschten Ergebnis.)

Zunächst werden mit Get-CsVoiceRoute sämtliche VoIP-Routen abgerufen und diese Auflistung der Variablen "$z" zugewiesen. In der folgenden Zeile wird eine foreach-Schleife gestartet. Diese Schleife weist ein Mitglied der Auflistung nach dem anderen der Variablen "$x" zu. Hierzu muss zunächst für "$x", die einen Verweis auf eine einzelne VoIP-Route enthält, der Identitätswert dieser Route angegeben werden: $x.Identity. Im folgenden Abschnitt des Befehls wird das Cmdlet Test-CsVoiceRoute aufgerufen, mit dem die Zielnummer mit der Route "$x" verglichen wird. Die endgültige Ausgabe ist eine (nicht sehr gut formatierte) Liste mit VoIP-Routenidentitätswerten, gefolgt von einer True/False-Kennzeichnung dazu, ob die Zielnummer mit dem Nummernmuster in der Route mit diesem Identitätswert übereinstimmt.