Test-CsVoiceTestConfiguration
Letztes Änderungsdatum des Themas: 2012-03-26
Testet VoIP-Konfigurationen, um die erwartete Funktionsweise von VoIP-Routing und -Richtlinien sicherzustellen.
Syntax
Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>]
Test-CsVoiceTestConfiguration -DialedNumber <PhoneNumber> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
Detaillierte Beschreibung
Vor der Implementierung von VoIP-Routen und -Richtlinien ist es sinnvoll, diese Einstellungen für verschiedene Telefonnummern zu testen, um die erwartete Funktionsweise sicherzustellen. Wenn Sie dieses Cmdlet mit den geeigneten Parametereinstellungen ausführen, können Sie diese Tests durchführen.
Dieses Cmdlet gleicht die Telefonnummer mit der VoIP-Route, der Verwendung, den Wähleinstellungen und der VoIP-Richtlinie ab, um das gewünschte Ergebnis zu überprüfen oder das tatsächliche Ergebnis mit dem erwarteten Ergebnis zu vergleichen. Die zu testenden VoIP-Konfigurationen können durch die einzelne Eingabe der geeigneten Parameter oder mit dem Cmdlet New-CsVoiceTestConfiguration definiert werden.
Wenn Sie Werte für "DialedNumber", "DialPlan" und "VoicePolicy" eingeben, umfasst die Ausgabe die übersetzte Nummer, die zum Erstellen dieser Übersetzung verwendete Normalisierungsregel, den verwendeten Router und die PSTN-Verwendung. Wenn Sie stattdessen einen Wert für den Parameter "TestCaseInputObject" eingeben, können Sie außerdem Statusinformationen dazu abrufen, ob die Resultate den erwarteten Ergebnissen entsprechen, die Sie bei Erstellung des Testobjekts mit dem Cmdlet New-CsVoiceTestConfiguration definiert haben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsVoiceTestConfiguration 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-CsVoiceTestConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
DialedNumber |
Erforderlich |
PhoneNumber |
Die für den Test verwendete Telefonnummer. Basierend auf dem Satz mit Wähleinstellungen, der Route und der Richtlinie wird diese Nummer normalisiert und als Ausgabe angezeigt. Dieser Parameter ist erforderlich, es sei denn für den Parameter "TestCaseInputObject" wurde ein Wert angegeben. Die Parameter "DialedNumber" und "TestCaseInputObject" können nicht innerhalb desselben Befehls verwendet werden. (Der Parameter "TestCaseInputObject" umfasst bereits einen Wert für "DialedNumber" innerhalb dieses Objekts.) |
Dialplan |
Erforderlich |
LocationProfile |
Ein Verweis auf ein Wähleinstellungsobjekt des Satzes mit Wähleinstellungen, der bei der Ausführung des Tests verwendet werden soll. Wähleinstellungsobjekte können mit dem Cmdlet Get-CsDialPlan abgerufen werden. Dieser Parameter ist erforderlich, wenn auch der Parameter "DialedNumber" angegeben wurde. Verwenden Sie diesen Parameter nicht, wenn Sie den Parameter "TestCaseInputObject" verwenden. Andernfalls muss das Objekt in diesem Parameter mit dem im Parameter "TestCaseInputObject" angegebenen Satz mit Wähleinstellungen übereinstimmen, wodurch die Verwendung dieses Parameters redundant wird. |
TestCaseInputObject |
Erforderlich |
TestConfiguration |
Ein Objekt mit einem Verweis auf die zu testende VoIP-Konfiguration. Dieser Objektverweis kann mit dem Cmdlet Get-CsVoiceTestConfiguration abgerufen werden. Wenn Sie das Cmdlet mit diesem Parameter aufrufen, kann kein Wert für "DialedNumber" angegeben werden. Ferner sollten keine Werte für "Dialplan" oder "VoicePolicy" angegeben werden, da diese aufgrund der Werte im VoIP-Testkonfigurationsobjekt redundant wären. |
VoicePolicy |
Erforderlich |
VoicePolicy |
Ein Verweis auf ein VoIP-Richtlinienobjekt der VoIP-Richtlinie, die bei der Ausführung des Tests verwendet werden soll. VoIP-Richtlinienobjekte können mit dem Cmdlet Get-CsVoicePolicy abgerufen werden. Dieser Parameter ist erforderlich, wenn auch der Parameter "DialedNumber" angegeben wurde. Verwenden Sie diesen Parameter nicht, wenn Sie den Parameter "TestCaseInputObject" verwenden. Andernfalls muss das Objekt in diesem Parameter mit der im Parameter "TestCaseInputObject" angegebenen VoIP-Richtlinie übereinstimmen, wodurch die Verwendung dieses Parameters redundant wird. |
RouteSettings |
Optional |
PstnRoutingSettings |
Ein Verweis auf ein Objekt mit allen in der Microsoft Lync Server 2010-Installation verfügbaren VoIP-Routen. Dieses Objekt kann mit dem Cmdlet Get-CsRoutingConfiguration abgerufen werden. Dieser Parameter kann mit dem Parameter "DialedNumber" oder mit dem Parameter "TestCaseInputObject" verwendet werden. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
Eingabetypen
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Testkonfigurationsobjekten.
Rückgabetypen
Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.OcsVoiceTestResult" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration
In diesem Beispiel wird ein VoIP-Konfigurationstest für die Konfiguration "TestConfig1" durchgeführt. Zunächst wird das Cmdlet Get-CsVoiceTestConfiguration ausgeführt, um die Konfiguration mit dem Identitätswert "TestConfig1" abzurufen. Dieses Konfigurationsobjekt wird dann an das Cmdlet Test-CsVoiceTestConfiguration weitergeleitet.
-------------------------- Beispiel 2 --------------------------
$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $a
Beispiel 2 ist mit Beispiel 1 identisch. Der einzige Unterschied besteht darin, dass die Ergebnisse der Get-Operation nicht direkt an das Test-Cmdlet weitergeleitet werden. Stattdessen wird das Objekt zunächst in der Variablen "$a" gespeichert und anschließend zur Verwendung als Testkonfiguration als Wert an den Parameter "TestCaseInputObject" übergeben.
-------------------------- Beispiel 3 --------------------------
$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp
In diesem Beispiel wird eine Konfiguration getestet, ohne dass diese zunächst mit New-CsVoiceTestConfiguration definiert werden muss. In diesem Beispiel wird kein zuvor erstelltes Objekt "TestConfiguration" übergeben. Stattdessen wird gezeigt, wie ein Test direkt eingerichtet wird, indem die zu testende gewählte Nummer sowie der Satz mit Wähleinstellungen und die VoIP-Richtlinie zur Durchführung des Tests angegeben werden.
In der ersten Zeile dieses Beispiels wird das Cmdlet Get-CsDialPlan aufgerufen, um den globalen Satz mit Wähleinstellungen abzurufen. Das abgerufene Wähleinstellungsobjekt wird der Variablen "$dp" zugewiesen. In der zweiten Zeile wird derselbe Vorgang für die VoIP-Richtlinie ausgeführt, indem das Cmdlet Get-CsVoicePolicy zum Abrufen der VoIP-Richtlinie "Global" aufgerufen wird. Anschließend wird diese Richtlinie der Variablen "$vp" zugewiesen.
Schließlich kann der Test ausgeführt werden. Zuerst wird Test-CsVoiceTestConfiguration aufgerufen, und die zu testende Telefonnummer wird an den Parameter "DialedNumber" übergeben, der in Zeile 1 abgerufenen Satz mit Wähleinstellungen (in der Variablen "$dp" gespeichert) wird an den Parameter "Dialplan" und die in Zeile 2 abgerufene VoIP-Richtlinie (in der Variablen "$vp" gespeichert) wird an den Parameter "VoicePolicy" übergeben.
Beachten Sie, dass die Ausgabe für Beispiel 3 nicht den Status für die erwarteten Ergebnisse umfasst. Wenn Sie die Ergebnisse mit den Erwartungen vergleichen möchten, müssen Sie diese Erwartungen mit dem Cmdlet New-CsVoiceTestConfiguration definieren und Test-CsVoiceTestConfiguration wie in den Beispielen 1 und 2 gezeigt aufrufen.