• Artikel

Get-CsVoiceTestConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft ein Testszenario ab, das zum Testen von Routen und Regeln für bestimmte Telefonnummern verwendet werden kann.

Syntax

Get-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceTestConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Mit dem Cmdlet werden die VoIP-Route, die Verwendung, Wähleinstellungen und die VoIP-Richtlinie abgerufen, die für eine angegebene Telefonnummer getestet werden sollen. Vor der Implementierung von VoIP-Routen und -Richtlinien ist es sinnvoll, diese Einstellungen für verschiedene Telefonnummern zu testen, um die erwartete Funktionsweise sicherzustellen. Sie können zum Testen mit diesem Cmdlet eine Testkonfiguration abrufen und dieses Szenario anschließend mit dem Cmdlet Test-CsVoiceConfiguration ausführen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Eine Zeichenfolge zum eindeutigen Identifizieren der Testkonfiguration, die abgerufen werden soll.

Filter

Optional

Zeichenfolge

Dieser Parameter ermöglicht eine Platzhaltersuche nach den definierten VoIP-Testkonfigurationen. (Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema.)

LocalStore

Optional

Switch-Parameter

Ruft die VoIP-Testkonfiguration aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Gibt mindestens ein Objekt vom Typ Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration zurück.

Beispiel

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

Get-CsVoiceTestConfiguration

Ruft alle Einstellungen für die VoIP-Testkonfiguration ab.

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

Get-CsVoiceTestConfiguration | Select-Object Identity, DialedNumber, ExpectedTranslatedNumber

In diesem Beispiel werden alle Einstellungen für die VoIP-Testkonfiguration abgerufen und nur die Parameter "Identity", "DialedNumber" und "ExpectedTranslatedNumber" angezeigt. Die vom Cmdlet Get-CsVoiceTestConfiguration zurückgegebenen Einstellungen werden an das Cmdlet Select-Object weitergeleitet, das die Ausgabe anschließend auf die Eigenschaften "Identity", "DialedNumber" und "ExpectedTranslatedNumber" einschränkt.

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

Get-CsVoiceTestConfiguration -Filter *test*

In diesem Beispiel wird der Parameter "Filter" dazu verwendet, alle Einstellungen für die VoIP-Testkonfiguration abzurufen, deren Identitätswerte die Zeichenfolge "test" enthalten. Das Platzhalterzeichen (*) am Anfang und am Ende des Filterwerts weist darauf hin, dass die Zeichenfolge "test" an beliebiger Stelle innerhalb des Identitätswerts enthalten sein kann, d. h., es können Zeichen vor oder nach der Zeichenfolge vorhanden sein. Dieser Befehl würde beispielsweise VoIP-Testkonfigurationen mit Namen wie "TestConfig", "VoiceNumberTest" und "VoiceTest1" zurückgeben.