Set-CsVoiceTestConfiguration
Letztes Änderungsdatum des Themas: 2012-03-27
Ändert ein Testszenario, das zum Testen von Routen und Regeln für bestimmte Telefonnummern verwendet werden kann.
Syntax
Set-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceTestConfiguration [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 geändert werden.
Über das Cmdlet Set-CsVoiceTestConfiguration werden VoIP-Route, Verwendung, Satz mit Wähleinstellungen und VoIP-Richtlinie geändert, die für eine angegebene Telefonnummer getestet werden sollen. All diese Informationen können über andere Cmdlets festgelegt und abgerufen werden (siehe Parameterbeschreibungen für dieses Thema).
Die mit diesem Cmdlet geänderten 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 Set-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 "Set-CsVoiceTestConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Eine Zeichenfolge zur eindeutigen Kennzeichnung des Testszenarios, das geändert werden soll. Da dieses Objekt nur mit dem globalen Gültigkeitsbereich erstellt werden kann, umfasst der Wert dieses Parameters keinen Gültigkeitsbereich. Aus diesem Grund ist nur ein Name erforderlich. |
Instance |
Optional |
TestConfiguration |
Ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration", das eine vorhandene VoIP-Testkonfiguration mit den Änderungen umfasst, die Sie an der Konfiguration vornehmen möchten. Objekte von diesem Typ können mit dem Cmdlet Get-CsVoiceTestConfiguraton abgerufen werden. |
DialedNumber |
Optional |
Zeichenfolge |
Die Telefonnummer, die zum Testen der Richtlinien, Verwendungen usw. verwendet werden soll. Dieser Wert kann maximal 512 Zeichen umfassen. |
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 das Ergebnis von "DialedNumber" nicht mit dem Wert in "ExpectedTranslatedNumber" übereinstimmt, gilt der Test als nicht erfolgreich. Dieser Wert kann maximal 512 Zeichen umfassen. |
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 über das Cmdlet Get-CsDialPlan abgerufen werden. Dieser Wert kann maximal 40 Zeichen umfassen. |
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. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
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
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Testkonfigurationsobjekten.
Rückgabetypen
Dieses Cmdlet gibt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 14255551212
In diesem Beispiel wird die gewählte Nummer der VoIP-Testkonfiguration für "TestConfig1" auf 14255551212 festgelegt. Für diese Nummer wird die VoIP-Richtlinie und -Route getestet, um das erwartete Normalisierungsverhalten zu überprüfen. Gleichzeitig soll sichergestellt werden, dass die richtigen Routen und Wähleinstellungen verwendet werden.
-------------------------- Beispiel 2 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -TargetDialplan site:Redmond1 -ExpectedTranslatedNumber "+912065551212"
In diesem Beispiel werden die Einstellungen für die VoIP-Testkonfiguration "TestConfig1" geändert. Der Befehl legt als "TargetDialplan " die Wähleinstellungen für "site:Redmond1" fest. Da das Ändern der Wähleinstellungen eine Änderung der Normalisierungsregeln zur Folge haben könnte, wurde auch der Wert von "ExpectedTranslationNumber" geändert, um das erwartete Verhalten der Normalisierungsregeln für diese Wähleinstellungen widerzuspiegeln.