Test-CsPhoneBootstrap
Letztes Änderungsdatum des Themas: 2012-03-26
Überprüft, ob sich ein Benutzer mit einem Microsoft Lync 2010 Phone Edition-kompatiblen Gerät bei Microsoft Lync Server 2010 anmelden kann.
Syntax
Test-CsPhoneBootstrap [-TargetFqdn <String>] -PhoneOrExt <String> -PIN <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>] [-UserSipAddress <String>]
Detaillierte Beschreibung
Um eine Verbindung mit Lync Server 2010 herzustellen, müssen Lync 2010 Phone Edition-kompatible Geräte das Dynamic Host Configuration Protocol (DHCP) verwenden, um die Adresse einer Lync Server-Registrierung abzurufen. Diese Geräte müssen auch über eine gültige Telefonnummer und eine zugeordnete persönliche Identifikationsnummer (PIN) verfügen, damit sie vom Gerät authentifiziert werden können. (Dieser Prozess wird auch "Bootstrapping" genannt.) Mit dem Cmdlet Test-CsPhoneBootstrap können Administratoren über die Telefonnummer und zugewiesene PIN eines bestimmten Benutzers überprüfen, ob dieser sich mit einem Lync 2010 Phone Edition-kompatiblen Gerät beim System anmelden kann. (Es wird kein tatsächliches Gerät benötigt, um diesen Test durchzuführen.)
Damit Test-CsPhoneBootstrap den Test durchführen kann, muss der Registrierungspool, der das zu testende Benutzerkonto hostet, mit DHCP erkannt werden. Verwenden Sie zur Bestimmung, ob eine Registrierung auf diese Weise erkennbar ist, das Cmdlet Get-CsRegistrarConfiguration, und überprüfen Sie den Wert der Eigenschaft "EnableDHCPServer". Wenn diese Eigenschaft auf "False" festgelegt ist, müssen Sie Set-CsRegistrarConfiguration verwenden, um den Eigenschaftswert auf "True" festzulegen und die Registrierung mit DHCP erkennbar zu machen. Hierzu können auch Enterprise-DHCP-Server verwendet und die Lync Server-spezifischen Optionen konfiguriert werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: 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-CsPhoneBootstrap"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
PhoneOrExt |
Erforderlich |
Zeichenfolge |
Telefonnummer oder Durchwahlnummer des Benutzerkontos, das getestet wird. Beispiel: -PhoneOrExt "+14255551219". |
PIN |
Erforderlich |
Zeichenfolge |
PIN des Benutzerkontos, das getestet wird. |
RegistrarPort |
Optional |
Ganze Zahl |
Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet. |
TargetFqdn |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des Registrierungspools, der das zu testende Benutzerkonto hostet. Wenn dieser nicht angegeben wird, dann wird der Registrierungspools mittels der DHCP-Ermittlung gesucht. |
TargetUri |
Optional |
Zeichenfolge |
URL des Zertifikatbereitstellungsdiensts. Wenn dieser Parameter nicht angegeben wurde, wird der Ziel-URI mit der DHCP-Ermittlung gesucht. |
UserSipAddress |
Optional |
Zeichenfolge |
SIP-Adresse für das im Text verwendeten Benutzerkonto. Beispiel: -UserSipAddress "sip:kenmyer@litwareinc.com". Der Parameter "UserSIPAddress" muss auf die angegebene Telefonnummer und PIN verweisen. Beim Durchführen des Tests tritt ein Fehler auf, wenn die angegebene Telefonnummer und PIN nicht zu dem im Parameter "UserSipAddress" festgelegten Benutzer gehören. Beachten Sie, dass die SIP-Adresse das Präfix "sip:" enthalten muss. |
OutVerboseVariable |
Optional |
Zeichenfolge |
Falls angegeben, wird nach Ausführung des Cmdlets die detaillierte Ausgabe in der angegebenen Variablen gespeichert. Geben Sie beispielsweise die folgende Syntax an, um die Ausgabe in der Variablen "$Testausgabe" zu speichern: -OutVerboseVariable TestOutput Setzen Sie kein Dollarzeichen ($) vor den Variablennamen. |
Force |
Optional |
GUID |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
Verbose |
Optional |
Zeichenfolge |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Eingabetypen
Keine. Test-CsPhoneBootstrap akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsPhoneBootstrap wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
Der Befehl in Beispiel 1 überprüft, ob der Benutzer mit der festgelegten Telefonnummer und PIN mit einem Lync 2010 Phone Edition-kompatiblen Gerät eine Verbindung mit Lync Server herstellen kann. Um den Test durchführen zu können, müssen die Telefonnummer (+14255551219) und die PIN (0712) des Benutzers angegeben werden.
-------------------------- Beispiel 2 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
Mit dem vorstehenden Befehl wird überprüft, ob der Benutzer mit der festgelegten Telefonnummer und PIN mit einem Lync 2010 Phone Edition-kompatiblen Gerät eine Verbindung mit Lync Server herstellen kann. In diesem Beispiel wird der Parameter "UserSipAddress" als zusätzliche Prüfung verwendet: Beim Durchführen des Tests tritt ein Fehler auf, wenn der Benutzer mit der SIP-Adresse nicht der Benutzer mit der angegebenen Telefonnummer und PIN ist.