Test-CsVoiceTestConfiguration

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

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.

Siehe auch

Weitere Ressourcen

New-CsVoiceTestConfiguration
Remove-CsVoiceTestConfiguration
Set-CsVoiceTestConfiguration
Get-CsVoiceTestConfiguration
Get-CsDialPlan
Get-CsVoicePolicy
Get-CsRoutingConfiguration