Test-CsGroupExpansion
上一次修改主题: 2012-03-27
测试用户使用组扩展的能力。通过 Microsoft Lync Server 2010,用户可以将 Active Directory 通讯组配置为联系人。“展开”组时,您将会看到该组中每个成员的名称和状态信息。
语法
Test-CsGroupExpansion -TargetFqdn <String> -GroupEmailAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsGroupExpansion -GroupEmailAddress <String> -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsGroupExpansion [-TargetFqdn <String>] -GroupEmailAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
详细说明
用户有时需要定期与 Active Directory 通讯组中的所有成员通信;例如,该组可能包含某个团队的所有成员,或者包含分配给特定项目的所有人员。认识到这一点之后,您就可以使用 Lync Server 2010 将通讯组配置为联系人。配置完成后,您只需将相同即时消息发送给该组而不是该组中每个单独的成员,就可以将该消息发送到所有组成员。
有时您也可能需要与该组中的某些个人通信(或者查看其状态)。通过组扩展,您可以快速简便地查看所有组成员及其当前状态。此外,您也可以选择一个或多个组成员,然后只将即时消息发送给这些用户而不是组中的所有成员。
可以使用 Set-CsWebServiceConfiguration cmdlet 启用和禁用组扩展。启用组展开后,您可以通过运行 Test-CsGroupExpansion cmdlet 来确定该功能是否正在工作。借助此 cmdlet,您可以使用组的电子邮件地址来指定 Active Directory 通讯组。然后,Test-CsGroupExpansion 可以使用组扩展检索组成员身份,并将检索到的列表与所提供的组成员电子邮件地址进行比较。如果两个列表匹配,则说明组扩展工作正常。
请注意,您可以采用两种不同方式测试组扩展:测试该服务自身或测试关联的 Web 服务。
谁能运行此 cmdlet:要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsGroupExpansion"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
GroupEmailAddress |
必需 |
字符串 |
目标通讯组的电子邮件地址。例如:-GroupEmailAddress "FinanceGroup@litwareinc.com"。 |
External |
可选 |
开关参数 |
用于验证外部用户是否可以使用组扩展。 |
RegistrarPort |
整数 |
字符串 |
Registrar 服务使用的 SIP 端口。如果 Registrar 使用默认端口 5061,则不需要指定此参数。 |
TargetFqdn |
可选 |
字符串 |
要在其中测试组展开的注册器池的完全限定域名 (FQDN)。例如:-TargetFqdn "atl-cs-001.litwareinc.com"。 请注意,不能在同一个命令中同时使用 TargetUri 参数和 TargetFqdn 参数。 |
TargetUri |
可选 |
字符串 |
组扩展 Web 服务的统一资源标识符 (URI)。例如:-TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion"。 请注意,不能在同一个命令中同时使用 TargetUri 参数和 TargetFqdn 参数。 |
UserCredential |
可选 |
PS 凭据对象 |
要在测试中使用的用户帐户的用户凭据对象。传递给 UserCredential 的值应是使用 Get-Credential cmdlet 获取的对象引用。例如,以下代码返回用户 litwareinc\kenmyer 的凭据对象,并将该对象存储在名为 $x 的变量中: $x = Get-Credential "litwareinc\kenmyer" 运行此命令时,您需要提供用户密码。 如果您要使用已登录用户的凭据运行测试并且要使用 TargetFqdn 参数,则不需要用户凭据。如果您要使用 TargetUri 参数,则需要用户凭据。 |
UserSipAddress |
可选 |
字符串 |
要在测试中使用的用户的 SIP 地址。如果未指定此参数,则 Test-CsGroupExpansion 将使用已登录用户的帐户执行其检查。 |
WebCredential |
可选 |
PS 凭据对象 |
包含用于访问位置信息服务的用户凭据的对象。可通过调用 Get-Credential cmdlet 并提供相应的凭据来检索该对象。 如果指定 TargetUri 和 UserSipAddress 参数,并且从中运行此命令的计算机没有服务器证书,则需要此参数。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
OutVerboseVariable |
可选 |
字符串 |
存在此参数时,运行该 cmdlet 的详细输出将存储在指定变量中。例如,若要将输出存储在名为 $TestOutput 的变量中,可使用以下语法: -OutVerboseVariable TestOutput 指定变量名称时不要在前面附加 $ 字符。 |
Verbose |
可选 |
GUID |
在该 cmdlet 运行时将详细活动显示在屏幕上。 |
输入类型
无。Test-CsGroupExpansion 不接受通过管道传递的输入。
返回类型
Test-CsGroupExpansion 返回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Test-CsGroupExpansion -TargetFqdn atl-cs-001.litwareinc.com -GroupEmailAddress FinanceGroup@litwareinc.com
示例 1 中显示的命令连接到注册器池 atl-cs-001.litwareinc.com 以验证组扩展。为了运行测试,该命令使用了组 FinanceGroup@litwareinc.com。