Test-CsMcxP2PIM
Letztes Änderungsdatum des Themas: 2013-05-28
Testet die Fähigkeit eines Benutzerpaars zum Austauschen von Sofortnachrichten über den Microsoft Lync Server 2010-Mobilitätsdienst. Dieser Dienst ermöglicht Benutzern von Mobiltelefonen wie iPhones und Windows Phones das Austauschen von Sofortnachrichten und Anwesenheitsinformationen, das interne Speichern und Abrufen von Voicemail anstatt beim Mobilfunkanbieter und das Ausnutzen von Microsoft Lync Server 2010-Funktionen wie "Geschäftlich anrufen" und der Konferenzoption für ausgehende Verbindungen.
Syntax
Test-CsMcxP2PIM -TargetFqdn <String> -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Der Microsoft Lync Server 2010-Mobilitätsdienst stellt viele der Funktionen von Microsoft Lync 2010 mobilen Geräten wie Apple iPhones, Windows Phones, Android- und Nokia-Telefonen zur Verfügung. Neben anderen Dingen können Benutzer dieser Telefone Sofortnachrichten und Anwesenheitsinformationen austauschen sowie Benachrichtigungen zu neuen Voicemails empfangen. Dank des Pushbenachrichtigungsdiensts (Apple-Pushbenachrichtigungsdienst und Microsoft Lync Server 2010-Pushbenachrichtigungsdienst) können Benutzer von iPhones oder Windows Phones diese Benachrichtigungen auch dann empfangen, wenn Lync 2010 im Hintergrund ausgeführt wird. Der Mobilitätsdienst bietet Organisationen auch die Möglichkeit, die Funktion "Geschäftlich anrufen" zu aktivieren. Diese Funktion ermöglicht es Benutzern, Anrufe auf ihrem Mobiltelefon zu tätigen und so erscheinen zu lassen, als würde der Anruf von ihrer geschäftlichen Telefonnummer stammen. Anrufer-ID-Systeme zeigen beispielsweise die geschäftliche Nummer des Benutzers und nicht seine Mobilfunknummer an.
Mit dem Cmdlet Test-CsMcxP2PIM kann bestimmt werden, ob ein Benutzerpaar Sofortnachrichten über den Mobilitätsdienst austauschen kann. Für die Ausführung dieses Cmdlets müssen weder Mobiltelefone tatsächlich verwendet noch Sofortnachrichten gesendet werden. Stattdessen prüft das Cmdlet, ob sich die beiden Benutzer bei Lync Server 2010 anmelden können und ob der Mobilitätsdienst die Verbindungen herstellen kann, die für den Austausch von Sofortnachrichten zwischen den beiden Benutzern benötigt werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsMcxP2PIM lokal auszuführen: RTCUniversalServerAdmins.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des zu testenden Pools. |
ReceiverCredential |
Erforderlich |
PSCredential |
Objekt mit Anmeldeinformationen für das erste der beiden zu testenden Benutzerkonten. Bei dem an "ReceiverCredential" übergebenen Wert muss es sich um einen Objektverweis handeln, der mit dem Cmdlet Get-Credential abgerufen wurde. Der folgende Code gibt beispielsweise ein Objekt mit Anmeldeinformationen für den Benutzer "litwareinc\pilar" zurück und speichert dieses Objekt in der Variablen "$y": $y = Get-Credential "litwareinc\pilar" Sie müssen beim Ausführen dieses Befehls das Benutzerkennwort angeben. |
ReceiverSipAddress |
Erforderlich |
Zeichenfolge |
Die SIP-Adresse für das erste der beiden zu testenden Benutzerkonten. Beispiel: -ReceiverSipAddress "sip:pilar@litwareinc.com" Der Parameter "ReceiverSipAddress" muss auf dasselbe Benutzerkonto wie der Parameter "ReceiverCredential" verweisen. |
SenderCredential |
Erforderlich |
PSCredential |
Objekt mit Anmeldeinformationen für das zweite der beiden zu testenden Benutzerkonten. Bei dem an "SenderCredential" übergebenen Wert muss es sich um einen Objektverweis handeln, der mit dem Cmdlet Get-Credential abgerufen wurde. Der folgende Code gibt beispielsweise ein Objekt mit Anmeldeinformationen für den Benutzer "litwareinc\kenmyer" zurück und speichert dieses Objekt in der Variablen "$x": $x = Get-Credential "litwareinc\kenmyer" Sie müssen beim Ausführen dieses Befehls das Benutzerkennwort angeben. |
SenderSipAddress |
Erforderlich |
Zeichenfolge |
Die SIP-Adresse für das zweite der beiden zu testenden Benutzerkonten. Beispiel: -SenderSipAddress "sip:kenmyer@litwareinc.com" Der Parameter "SenderSipAddress" muss auf dasselbe Benutzerkonto wie der Parameter "SenderCredential" verweisen. |
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 Testausgabe Setzen Sie kein Dollarzeichen ($) vor den Variablennamen. |
RegistrarPort |
Optional |
Ganze Zahl |
Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet. |
Verbose |
Optional |
Switch-Parameter |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Eingabetypen
Keine. Test-CsMcxP2PIM akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsMcxP2PIM wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\pilar"
Test-CsMcxP2PIM -TargetFqdn "atl-cs-001.litwareinc.com" -Authentication Negotiate -SenderSipAddres "sip:kenmyer@litwareinc.com" -SenderCredential $credential1 -ReceiverSipAddress "sip:packerman@litwareinc.com" -ReceiverCredential $credential2
Mit den Befehlen in Beispiel 1 wird getestet, ob das Benutzerpaar Ken Myer und Pilar Ackerman Sofortnachrichten über den Mobilitätsdienst austauschen kann. Hierzu werden in den ersten beiden Befehlen des Beispiels mit dem Cmdlet Get-Credential Anmeldeinformationsobjekte für die beiden Benutzer erstellt. Die Anmeldeinformationen von Ken Myer werden in der Variablen "$credential1", die für Pilar Ackerman in der Variablen "$credential2" gespeichert.
Nachdem die Anmeldeinformationsobjekte erstellt wurden, wird im letzten Befehl das Cmdlet Test-CsMcxP2PIM aufgerufen, um den Zielregistrierungspool (atl-cs-001.litwareinc,com), den Authentifizierungstyp (Negotiate) sowie die SIP-Adressen und Anmeldeinformationen der beiden Benutzer anzugeben.