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 地址和凭据。