• Artikel

Test-CsVoicePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-26

Testet eine Telefonnummer für eine VoIP-Richtlinie und bestimmt, welche VoIP-Route für die Richtlinie dieser Nummer verwendet werden soll.

Syntax

Test-CsVoicePolicy -TargetNumber <PhoneNumber> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]

Detaillierte Beschreibung

VoIP-Richtlinien sind an VoIP-Routen über die Verwendung eines Telefonfestnetzes (Public Switched Telephone Network, PSTN) gebunden. Ein Anruf eines Benutzers, dem eine bestimmte VoIP-Richtlinie zugewiesen wurde, kann nur über eine Route übertragen werden, deren PSTN-Verwendung einer Verwendung in der Richtlinie entspricht und deren Nummernmuster der gewählten Nummer entspricht. Rufen Sie das Cmdlet Test-CsVoicePolicy auf, um zu bestimmen, welche Route (falls vorhanden) zum Weiterleiten eines Anrufs von einem Benutzer mit einer bestimmten VoIP-Richtlinie verwendet wird und welche Telefonverwendung die Richtlinie an die Route bindet.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Test-CsVoicePolicy lokal ausfü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-CsVoicePolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

TargetNumber

Erforderlich

PhoneNumber

Die für den Test verwendete Telefonnummer. Diese Nummer muss im E.164-Format vorliegen (z. B. +14255551212).

Vollständiger Datentyp: Microsoft.Rtc.Management.Voice.PhoneNumber

VoicePolicy

Erforderlich

VoicePolicy

Ein Verweis auf ein VoIP-Richtlinienobjekt, für das der Test ausgeführt wird. VoIP-Richtlinienobjekte können mit dem Cmdlet Get-CsVoicePolicy abgerufen werden.

Vollständiger Datentyp: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy

RouteSettings

Optional

PstnRoutingSettings

Die für den Test verwendeten Routeneinstellungen. Die Routeneinstellungen können über einen Aufruf des Cmdlets Get-CsRoutingConfiguration abgerufen werden.

Vollständiger Datentyp: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Bestätigungsaufforderungen oder Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Cmdlets auftreten können.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Richtlinienobjekten.

Rückgabetypen

Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.VoicePolicyTestResult" zurück.

Beispiel

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

Get-CsVoicePolicy -Identity site:Redmond | Test-CsVoicePolicy -TargetNumber "+14255559999"

In diesem Beispiel wird ein VoIP-Richtlinientest für die VoIP-Richtlinie mit der Identität "site:Redmond" ausgeführt. Zunächst wird das Cmdlet Get-CsVoicePolicy ausgeführt, um die Richtlinie mit dem Identitätswert "site:Redmond" abzurufen. Das Richtlinienobjekt wird dann an das Cmdlet Test-CsVoicePolicy weitergeleitet, das die Richtlinie für die Telefonnummer +14255559999 testet. Die Ausgabe ist die erste VoIP-Route (basierend auf der Eigenschaft "Priority" der Route), die ein Nummernmuster aufweist, das dem Wert von "TargetNumber" entspricht, und eine Telefonverwendung hat, die einer Telefonverwendung in der Richtlinie entspricht. Wenn keine übereinstimmende Route gefunden wird (z. B., wenn das Nummernmuster einer elfstelligen Nummer entspricht und Sie eine siebenstellige Nummer angeben), wird ein NULL-Wert zurückgegeben.

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

$a = Get-CsVoicePolicy -Identity site:Redmond
Test-CsVoicePolicy -TargetNumber "+14255559999" -VoicePolicy $a

Beispiel 2 ist mit Beispiel 1 identisch. Der einzige Unterschied ist, dass die Ergebnisse der Get-Operation nicht direkt an das Cmdlet "Test" weitergeleitet werden. Stattdessen wird das Objekt zunächst in der Variablen "$a" gespeichert und anschließend zur Verwendung als Wert für den Parameter "VoicePolicy" übergeben, der als Richtlinie verwendet wird, für die der Test ausgeführt wird.

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

Get-CsVoicePolicy | Test-CsVoicePolicy -TargetNumber "+12065559999"

In diesem Beispiel wird ein VoIP-Richtlinientest für sämtliche VoIP-Richtlinien ausgeführt, die innerhalb der Lync Server 2010-Bereitstellung definiert sind. Zunächst wird das Cmdlet Get-CsVoicePolicy ohne Parameter ausgeführt, um alle VoIP-Richtlinien abzurufen. Die zurückgegebene Auflistung von Richtlinien wird anschließend an das Cmdlet Test-CsVoicePolicy weitergeleitet, das jede Richtlinie in der Auflistung basierend auf der angegebenen Zieltelefonnummer (+12065559999) und den Telefonverwendungen auf eine übereinstimmende Route überprüft. Die Ausgabe enthält eine Liste übereinstimmender Routen und die übereinstimmenden Telefonverwendungen.