New-CsVoiceTestConfiguration
Letztes Änderungsdatum des Themas: 2012-03-27
Erstellt ein Testszenario, das zum Testen von Routen und Regeln für bestimmte Telefonnummern verwendet werden kann.
Syntax
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
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. Zu diesem Zweck können mit diesem Cmdlet Testszenarien erstellt werden.
Über das Cmdlet New-CsVoiceTestConfiguration werden die Elemente definiert, die für eine angegebene Telefonnummer getestet werden sollen, d. h. die VoIP-Route, die Verwendung, der Satz mit Wähleinstellungen und die VoIP-Richtlinie. All diese Informationen können über andere Cmdlets festgelegt und abgerufen werden. Weitere Informationen finden Sie in den Beschreibungen dieser Parameter für dieses Thema.
Die mit diesem Cmdlet erstellten Konfigurationen werden mithilfe des Cmdlets Test-CsVoiceTestConfiguration getestet.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-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 "New-CsVoiceTestConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsGlobalRelativeIdentity |
Eine Zeichenfolge, die dieses Testszenario eindeutig identifiziert. Diese Zeichenfolge kann bis zu 32 Zeichen lang sein und kann beliebige alphanumerische Zeichen sowie umgekehrte Schrägstriche (\), Punkte (.) oder Unterstriche (_) enthalten. Da dieses Objekt nur mit dem globalen Gültigkeitsbereich erstellt werden kann, umfasst der Wert dieses Parameters keinen Gültigkeitsbereich. Aus diesem Grund ist ein eindeutiger Name erforderlich. |
Name |
Erforderlich |
Zeichenfolge |
Dieser Parameter enthält denselben Wert wie "Identity". Wenn der Parameter "Identity" angegeben wird, können Sie nicht den Parameter "Name" in Ihren Befehl einschließen. Ebenso kann der Parameter "Identity" nicht verwendet werden, wenn bereits der Parameter "Name" angegeben wurde. |
DialedNumber |
Optional |
Zeichenfolge |
Die Telefonnummer, die zum Testen der Richtlinien, Verwendungen usw. verwendet werden soll. Dieser Wert kann maximal 512 Zeichen umfassen. Standard: 1234 |
ExpectedRoute |
Optional |
Zeichenfolge |
Der Name der erwarteten VoIP-Route während des Konfigurationstests. Wenn basierend auf dem Zielsatz mit Wähleinstellungen und der VoIP-Richtlinie eine andere Route verwendet wird, kann der Test nicht erfolgreich abgeschlossen werden. Die verfügbaren VoIP-Routen können über das Cmdlet Get-CsVoiceRoute abgerufen werden. Dieser Wert kann maximal 256 Zeichen umfassen. |
ExpectedTranslatedNumber |
Optional |
Zeichenfolge |
Die Telefonnummer im erwarteten Format nach der Übersetzung. Dabei handelt es sich um den Wert des Parameters "DialedNumber" nach der Normalisierung. Wenn Sie Test-CsVoiceTestConfiguration ausführen und der Wert von "DialedNumber" nicht mit dem Wert in "ExpectedTranslatedNumber" übereinstimmt, gilt der Test als nicht erfolgreich. Dieser Wert kann maximal 512 Zeichen umfassen. Standard: +1234 |
ExpectedUsage |
Optional |
Zeichenfolge |
Der Name der erwarteten PSTN-Verwendung während des Konfigurationstests. Wenn basierend auf dem Zielsatz mit Wähleinstellungen und der VoIP-Richtlinie eine andere PSTN-Verwendung eingesetzt wird, kann der Test nicht erfolgreich abgeschlossen werden. Die verfügbaren Telefonverwendungen können über Get-CsPstnUsage abgerufen werden. Dieser Wert kann maximal 256 Zeichen umfassen. |
TargetDialplan |
Optional |
Zeichenfolge |
Der Identitätswert der Wähleinstellungen, die für diesen Test verwendet werden sollen. Wähleinstellungen können durch Aufrufen des Cmdlets Get-CsDialPlan abgerufen werden. Dieser Wert kann maximal 40 Zeichen umfassen. Standard: Global |
TargetVoicePolicy |
Optional |
Zeichenfolge |
Der Identitätswert der VoIP-Richtlinie, für die dieser Test ausgeführt werden soll. VoIP-Richtlinien können über Get-CsVoicePolicy abgerufen werden. Dieser Wert kann maximal 40 Zeichen umfassen. Standard: Global |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
InMemory |
Optional |
Switch-Parameter |
Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Keine.
Rückgabetypen
Dieses Cmdlet erstellt ein Objekt vom Typ Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.
Beispiel
-------------------------- Beispiel 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
In diesem Beispiel wird eine neue VoIP-Testkonfiguration mit der Identität "TestConfig1" erstellt, die die Standardwerte verwendet.
-------------------------- Beispiel 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
In diesem Beispiel wird eine neue VoIP-Testkonfiguration namens "TestConfig1" erstellt und der Parameter "TargetDialplan" auf "site:Redmond1" festgelegt. Auf diese Weise werden die Einstellungen der Wähleinstellungen für den Standort "Redmond1" für die erwartete Nummer, Verwendung und Route getestet.
In diesem Beispiel wird "TestConfig1" ohne Angabe des Parameters "Identity" deklariert. Da "Identity" ein Positionsparameter ist, wird der erste Wert im Befehl, der auf den Cmdlet-Namen folgt, vom Cmdlet als Identität erkannt.
-------------------------- Beispiel 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
In diesem Beispiel wird eine neue VoIP-Testkonfiguration namens "TestConfig1" erstellt. Diese Konfiguration verwendet die Standardwerte, um die erwartete Ausgabe (ExpectedTranslatedNumber) +5551212 für die gewählte Nummer (DialedNumber) 5551212 zu testen. Dieser erwartete Wert basiert auf den Normalisierungsregeln, die den Wähleinstellungen zugeordnet sind, die zum Testen des Objekts verwendet werden. Dieser Test muss mit dem Cmdlet Test-CsVoiceTestConfiguration ausgeführt werden.