Test-CsVoiceUser
Letztes Änderungsdatum des Themas: 2012-03-26
Identifiziert die Route, die ein Telefonanruf von einem bestimmten Benutzer basierend auf VoIP-Regeln, -Routen und -Richtlinien bis zu seinem Abschluss durchläuft.
Syntax
Test-CsVoiceUser -DialedNumber <PhoneNumber> -SipUri <UserIdParameter> [-Force <SwitchParameter>]
Detaillierte Beschreibung
Wenn ein Benutzer einen Anruf tätigt, hängt die Route, die der Anruf bis zu seinem Ziel durchläuft, von den Richtlinien und Wähleinstellungen des jeweiligen Benutzers ab. Bei Angabe der SIP-Adresse und der Telefonnummer eines Benutzers gibt dieses Cmdlet Folgendes zurück: die ins E.164-Format übersetzte Nummer (basierend auf den Wähleinstellungen des Benutzers), die Normalisierungsregel, welche die Übersetzung bereitgestellt hat, die erste Route (basierend auf der Eigenschaft "Priority" der Route) mit einem der Telefonnummer entsprechenden Nummernmuster und die Telefonverwendung, welche die VoIP-Richtlinie des jeweiligen Benutzers mit der VoIP-Route verbinden würde.
Mithilfe dieses Cmdlet können Sie ermitteln, ob eine bestimmte Telefonnummer erwartungsgemäß und den Benutzereinstellungen entsprechend geroutet und übersetzt wird. Ferner eignet es sich zur Behandlung von Problemen einzelner Benutzer.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsVoiceUser 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-CsVoiceUser"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
DialedNumber |
Erforderlich |
PhoneNumber |
Die zu testende Telefonnummer. Vollständiger Datentyp: Microsoft.Rtc.Management.Voice.PhoneNumber |
SipUri |
Erforderlich |
Zeichenfolge |
Der SIP-URI des Benutzers, für den der Test stattfindet. Hierbei handelt es sich um den Identitätswert des Benutzers, wie er in den CsUser-Cmdlets verwendet wird. Sie können eine Benutzeridentität in einem von vier Formaten angeben: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer"). Beachten Sie, dass "SAMAccountName" nicht als Identitätswert verwendet werden kann. |
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
Keine.
Rückgabetypen
Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.OcsVoiceUserTestResult" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri "sip:kmyer@litwareinc.com" -Verbose
In diesem Beispiel wird ein VoIP-Benutzertest für den Benutzer mit der SIP-Adresse "sip:kmyer@litwareinc.com" ausgeführt. Der Test wird für die Telefonnummer durchgeführt, die über den Parameter "DialedNumber" ("+14255559999") bereitgestellt wird. Wenn keine passenden Regeln oder Routen festgestellt werden, gibt dieses Cmdlet einen Nullwert zurück. Beachten Sie, dass auch der Parameter "Verbose" einbezogen wurde. Bei "Verbose" handelt es sich um einen allgemeinen Windows PowerShell-Parameter, der während der Durchführung des Tests zusätzliche Informationen anzeigt, z. B. welche Wähleinstellungen und welche VoIP-Richtlinie für den Test geladen werden.
-------------------------- Beispiel 2 --------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri $_.SipAddress} | Format-List
In diesem Beispiel wird ein VoIP-Routingtest für alle für Lync Server 2010 oder Office Communications Server aktivierten Benutzer durchgeführt. Der Befehl beginnt mit dem Aufruf von Get-CsUser, das eine Auflistung aller für Lync Server 2010 oder Office Communications Server aktivierten Benutzer zurückgibt. In diesem Beispiel wird die Auflistung von Benutzern anschließend an das Cmdlet ForEach-Object weitergeleitet. Dieses Cmdlet untersucht jedes einzelne Benutzerobjekt und führt die in geschweiften Klammern ({}) angegebenen Aktionen durch.
Die erste Aktion besteht darin, den Anzeigenamen des aktuellen Benutzers auszugeben. (Der aktuelle Benutzer wird durch die Zeichen "$_" dargestellt; der Anzeigename befindet sich daher in der Eigenschaft "DisplayName" von "$_".) Das aktuell getestete Benutzerkonto wird angezeigt. Danach wird das Cmdlet Test-CsVoiceUser aufgerufen; diesem werden "DialedNumber" ("+14255559999") und "SipUri" des aktuellen Benutzers übergeben. In diesem Beispiel verwenden wir die SIP-Adresse des Benutzers ($_.SipAddress).
Da die Ausgabe standardmäßig im Tabellenformat vorliegt und möglicherweise zur Anpassung an die Bildschirmbreite abgeschnitten wird, werden die Testergebnisse in das Cmdlet Format-List ausgegeben, damit die Anzeigenamen der einzelnen Benutzer gefolgt von einer Linie für jedes Ausgabefeld angezeigt werden.