Test-CsIM

 

上一次修改主题： 2012-03-26

测试两个用户能否交换即时消息。

语法

Test-CsIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]

Test-CsIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

详细说明

Test-CsIM 是 Microsoft Lync Server 2010“综合事务”的一个示例。Lync Server 2010 中使用综合事务来验证用户是否能够成功完成常见任务，如登录系统、交换即时消息，或者拨打位于公用电话交换网 (PSTN) 中的电话。这些测试可以由管理员手动执行，也可以通过应用程序（如 Microsoft System Center Operations Manager（以前称为 Microsoft Operations Manager））自动运行。

通常以两种不同的方式执行综合事务。许多管理员会使用 CsHealthMonitoringConfiguration cmdlet 为其每一个注册器池设置测试用户。这些测试用户是预先配置的与综合事务配合使用的一对用户。（通常，这些帐户是测试帐户，而不是属于实际用户的帐户。）为池配置测试用户后，管理员只需对该池运行综合事务，而不必指定测试中所涉及的用户帐户的标识（也不必提供该帐户的凭据）。

此外，管理员也可以使用真实的用户帐户运行综合事务。例如，如果两个用户无法交换即时消息，则管理员可使用这两个相关的用户帐户（而非一对测试帐户）运行综合事务以尝试诊断和解决问题。如果决定使用实际用户帐户执行综合事务，您需要提供每个用户的凭据。

Test-CsIM cmdlet 首先尝试让一对测试用户登录到 Lync Server。假定这两次登录成功，则 cmdlet 随后将在这两个测试用户之间发起即时消息 (IM) 会话。（用户 1 邀请用户 2 加入 IM 会话，然后用户 2 接受邀请。）验证能否在两个用户之间交换消息之后，Test-CsIM 结束该 IM 会话，并将这两个用户从系统中注销。

谁能运行此 cmdlet：要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsIM"}

参数

参数	必需	类型	描述
ReceiverCredential	必需	PS 凭据对象	要测试的两个用户帐户中第一个用户帐户的用户凭据对象。传递给 ReceiverCredential 的值应是使用 Get-Credential cmdlet 获取的对象引用。例如，以下代码返回用户 litwareinc\pilar 的凭据对象，并将该对象存储在名为 $y 的变量中： $y = Get-Credential "litwareinc\pilar" 运行此命令时，需要提供用户密码。 如果您使用池的运行状况监控配置设置来运行测试，则不需要接收方凭据。
ReceiverSipAddress	可选	字符串	要测试的两个用户帐户中第一个用户帐户的 SIP 地址。例如：-ReceiverSipAddress "sip:jhaas@litwareinc.com"。ReceiverSipAddress 参数必须与 ReceiverCredential 引用相同的用户帐户。 如果您使用池的运行状况监控配置设置来运行测试，则不需要 SIP 地址。
SenderCredential	必需	PS 凭据对象	要测试的两个用户帐户中第二个用户帐户的用户凭据对象。传递给 SenderCredential 的值应是使用 Get-Credential cmdlet 获取的对象引用。例如，以下代码返回用户 litwareinc\kenmyer 的凭据对象，并将该对象存储在名为 $x 的变量中： $x = Get-Credential "litwareinc\kenmyer" 运行此命令时，需要提供用户密码。 如果您使用池的运行状况监控配置设置来运行测试，则不需要发送方凭据。
SenderSipAddress	必需	字符串	要测试的两个用户帐户中第二个用户帐户的 SIP 地址。例如：-SenderSipAddress "sip:kenmyer@litwareinc.com"。SenderSipAddress 参数必须与 SenderCredential 引用相同的用户帐户。 如果您使用池的运行状况监控配置设置来运行测试，则不需要 SIP 地址。
TargetFqdn	必需	字符串	要测试的池的完全限定域名 (FQDN)。
RegistrarPort	可选	整数	注册器服务使用的 SIP 端口。如果 Registrar 使用默认端口 5061，则不需要此参数。
OutVerboseVariable	可选	字符串	存在此参数时，运行该 cmdlet 的详细输出将存储在指定变量中。例如，若要将输出存储在名为 $TestOutput 的变量中，可使用以下语法： -OutVerboseVariable TestOutput 指定变量名称时不要在前面附加 $ 字符。
Force	可选	开关参数	禁止显示运行此命令时可能出现的任何非严重错误消息。
Verbose	可选	开关参数	cmdlet 运行过程中，在屏幕上报告详细的活动情况。

输入类型

无。Test-CsIM 不接受通过管道传递的输入。

返回类型

Test-CsIM 返回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 对象的实例。

示例

-------------------------- 示例 1 --------------------------

Test-CsIm -TargetFqdn atl-cs-001.litwareinc.com

上述示例查看预先配置的一对测试用户能否登录池 atl-cs-001.litwareinc.com，然后交换即时消息。只有已为池 atl-cs-001.litwareinc.com 定义了测试用户时，此命令才会有效。如果已定义，则此命令将确定两个用户能否登录系统，如果能够登录，则随后还将确定这两个用户能否交换即时消息。I

如果尚未定义测试用户，则此命令将失败，因为它不知道进行测试时使用哪个用户。如果没有为池定义注册器，则必须包含 SenderSipAddress 和 ReceiverSipAddress 参数以及 IM 会话中涉及的用户的相应凭据。然后，Test-CsIM 将使用这两个指定的用户执行其检查。

-------------------------- 示例 2 --------------------------

$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"

Test-CsIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2

示例 2 中显示的命令测试一对用户（litwareinc\pilar 和 litwareinc\kenmyer）能否登录 Lync Server，然后交换即时消息。为执行此操作，示例中的第一个命令使用 Get-Credential cmdlet 创建一个包含用户 Pilar Ackerman 的名称和密码的 Windows PowerShell 凭据对象。（由于包含的登录名 litwareinc\pilar 用作参数，因此，Windows PowerShell 凭据请求对话框将仅要求管理员输入 Pilar Ackerman 帐户的密码。）然后将得到的凭据对象存储在名为 $cred1 的变量中。第二个命令执行相同操作，但这次返回的是 Ken Myer 帐户的凭据对象。

有了这两个凭据对象，示例中的第三个命令即确定这两个用户能否登录 Lync Server，然后交换即时消息。为执行此操作，调用了带有以下参数的 Test-CsIM：TargetFqdn（注册器池的 FQDN）、SenderSipAddress（第一个测试用户的 SIP 地址）、SenderCredential（包含此用户的凭据的 Windows PowerShell 对象）、-ReceiverSipAddress（另一个测试用户的 SIP 地址）以及 ReceiverCredential（包含另一个用户的凭据的 Windows PowerShell 对象）。

另请参阅

其他资源

Test-CsGroupIM