Test-CsMcxP2PIM
上一次修改主题: 2013-05-28
测试一对用户使用 Microsoft Lync Server 2010 Mobility Service 交换即时消息的能力。Mobility Service 使移动电话(如 iPhone 和 Windows Phone)用户能够执行如下操作:交换即时消息和状态信息;在内部而不是使用其无线提供商存储和检索语音邮件;以及利用 Microsoft Lync Server 2010 功能(如通过工号拨号和电话拨出式会议)。
语法
Test-CsMcxP2PIM -TargetFqdn <String> -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
详细说明
Microsoft Lync Server 2010 Mobility Service 将 Microsoft Lync 2010 的许多功能扩展到移动设备(如 Apple iPhone、Windows Phone、Android 手机和 Nokia 手机)中。用户主要可以使用这些手机交换即时信息和状态信息,以及接收新语音邮件的通知。借助推送通知服务(Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务),即使 Lync 2010 在后台运行,使用 iPhone 或 Windows Phone 的用户也可以接收这些通知。Mobility Service 还为组织提供了实现通过工号拨号的机会。凭借通过工号拨号,用户可以从其移动电话发起呼叫,并使其显示为来自其工作电话的呼叫;例如,来电显示系统将显示用户的工作号码,而不是其移动电话号码。
Test-CsMcxP2PIM cmdlet 用于确定一对用户是否能够使用 Mobility Service 交换即时消息。注意,运行此 cmdlet 不需要使用移动电话,也不实际发送任何即时消息。此 cmdlet 只验证这两个用户能否登录 Lync Server 2010,以及 Mobility Service 能否建立在这两个用户之间交换即时消息所需的连接。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Test-CsMcxP2PIM cmdlet:RTCUniversalServerAdmins。
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
TargetFqdn |
必需 |
字符串 |
要测试的池的完全限定域名 (FQDN)。 |
ReceiverCredential |
必需 |
PSCredential |
要测试的两个用户帐户中第一个用户帐户的用户凭据对象。传递给 ReceiverCredential 的值应是使用 Get-Credential cmdlet 获取的对象引用。例如,以下代码返回用户 litwareinc\pilar 的凭据对象,并将该对象存储在名为 $y 的变量中: $y = Get-Credential "litwareinc\pilar" 运行此命令时,需要提供用户密码。 |
ReceiverSipAddress |
必需 |
字符串 |
要测试的两个用户帐户中第一个用户帐户的 SIP 地址。例如: -ReceiverSipAddress "sip:pilar@litwareinc.com" ReceiverSIPAddress 参数必须与 ReceiverCredential 参数引用同一用户帐户。 |
SenderCredential |
必需 |
PSCredential |
要测试的两个用户帐户中第二个用户帐户的用户凭据对象。传递给 SenderCredential 的值应是使用 Get-Credential cmdlet 获取的对象引用。例如,以下代码返回用户 litwareinc\kenmyer 的凭据对象,并将该对象存储在名为 $x 的变量中: $x = Get-Credential "litwareinc\kenmyer" 运行此命令时,需要提供用户密码。 |
SenderSipAddress |
必需 |
字符串 |
要测试的两个用户帐户中第二个用户帐户的 SIP 地址。例如: -SenderSipAddress "sip:kenmyer@litwareinc.com" SenderSipAddress 参数必须与 SenderCredential 参数引用同一用户帐户。 |
OutVerboseVariable |
可选 |
字符串 |
存在此参数时,运行该 cmdlet 的详细输出将存储在指定变量中。例如,若要将输出存储在名为 $TestOutput 的变量中,可使用以下语法: -OutVerboseVariable TestOutput 指定变量名称时不要在前面附加 $ 字符。 |
RegistrarPort |
可选 |
整数 |
注册器服务使用的 SIP 端口。如果 Registrar 使用默认端口 5061,则不需要此参数。 |
Verbose |
可选 |
开关参数 |
cmdlet 运行过程中,在屏幕上报告详细的活动情况。 |
输入类型
无。Test-CsMcxP2PIM 不接受通过管道传递的输入。
返回类型
Test-CsMcxP2PIM 返回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 对象的实例。
示例
-------------------------- 示例 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
示例 1 中显示的命令测试一对用户(Ken Myer 和 Pilar Ackerman)能否使用 Mobility Service 交换即时消息。为此,示例中的前两个命令使用 Get-Credential cmdlet 为这两个用户创建凭据对象;Ken Myer 的凭据存储在名为 $credential1 的变量中,Pilar Ackerman 的凭据存储在名为 $credential2 的变量中。
创建凭据对象后,最后一个命令调用 Test-CsMcxP2PIM cmdlet,以确保指定这两个用户的目标注册器池 (atl-cs-001.litwareinc,com)、身份验证类型 (Negotiate) 以及 SIP 地址和凭据。