Get-CsUserAcp
上一次修改主题： 2012-03-23
返回有关分配给用户或用户组的音频会议提供商的信息。
语法
Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]
详细说明
音频会议提供商是为组织提供会议服务的第三方公司。音频会议提供商的功能之一是为外出且未连接到企业网络或 Internet 的用户提供了一种通过音频参加会议的方法。音频会议提供商通常会提供一些高端服务，如实时翻译、转录和每个会议的实时接线员协助。
Microsoft Lync Server 2010 不允许与音频会议提供商完全集成。通过 CsUserAcp cmdlet，管理员可以设置电话号码和密码，以及配置每次用户安排会议时都可用于音频会议提供商集成的其他信息。但是，由于这些 cmdlet 并非旨在用于 Lync Server 的内部版本（而是主要用于与 Microsoft Lync Online 2010 配合使用），因此除分配属性值外，未提供其他音频会议提供商集成。
Get-CsUserAcp cmdlet 使您可以返回有关已分配给用户或用户组的音频会议提供商的信息。要返回单个用户的音频会议提供商信息，只需包含 Identity 参数，后跟要返回其信息的用户的 Identity。要返回多个用户的信息，可以使用 LdapFilter 参数或 Filter 参数。指定用户帐户信息时，LdapFilter 参数使您可以使用 Active Directory 常规属性（如 Department 或 Title），例如，参数值“Title=Accountant”可将返回信息限制为职务为 Accountant 的用户。通过 Filter 参数，您可以使用特定于 Microsoft Lync Server 2010 的属性（如 VoicePolicy 或 EnterpriseVoiceEnabled）来筛选返回的数据。例如，筛选器值 {EnterpriseVoiceEnabled –eq $True} 将 Get-CsUserAcp 返回的用户帐户限制为已启用企业语音的用户。
或者，您可以调用不带任何参数的 Get-CsUserAcp，以返回所有用户的音频会议提供商信息。请注意，Get-CsUserAcp 可返回所有用户的音频会议提供商信息，包括尚未启用 Lync Server 的用户。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsUserAcp cmdlet：RTCUniversalUserAdmins、RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserAcp"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
用户标识 |
指示要检索的用户帐户的标识。可以使用以下四种格式之一指定用户的标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 域服务 (AD DS) 显示名称（例如 Ken Myer）。此外，还可以使用用户的 Active Directory 可分辨名称引用用户帐户。 在使用显示名称作为用户标识时，可以使用通配符星号 (*)。例如，Identity "* Smith" 将返回显示名称以字符串值“ Smith”结尾的所有用户。 |
Credential |
可选 |
PS 凭据对象 |
使您可以通过备用凭据运行 Get-CsUserAcp cmdlet。如果您登录 Windows 时所使用的帐户没有使用联系人对象所需的必要权限，则可能需要使用该对象。 要使用 Credential 参数，必须首先通过 Get-Credential cmdlet 创建 PSCredential 对象。有关详细信息，请参阅 Get-Credential cmdlet 帮助主题。 |
Filter |
可选 |
字符串 |
用于通过筛选特定于 Lync Server 的属性来限制返回的数据。例如，您可以将返回数据限制为已分配特定语音策略的用户，或者限制为尚未分配特定语音策略的用户。 Filter 参数与 Where-Object cmdlet 使用相同的 Windows PowerShell 筛选语法。例如，仅返回已启用企业语音的用户的筛选器语法如下，其中，EnterpriseVoiceEnabled 代表 Active Directory 域服务 (AD DS)属性，-eq 代表比较运算符（等于），$True（内置的 Windows PowerShell 变量）代表筛选器值： {EnterpriseVoiceEnabled -eq $True} |
LdapFilter |
可选 |
字符串 |
使您可以通过筛选 Active Directory 常规属性（即不是特定于 Lync Server 的属性）来限制返回的数据。例如，您可以将返回数据限制为在特定部门工作的用户，或者拥有指定的经理或其他职务的用户。 LdapFilter 参数在创建筛选器时使用 LDAP 查询语言。例如，仅返回在 Redmond 市工作的用户的筛选器语法如下："l=Redmond"，其中“l”（小写的 L）代表 Active Directory 属性 (locality)；“=”代表比较运算符（等于）；“Redmond”代表筛选器值。 |
ResultSize |
可选 |
整数 |
使您可以限制命令返回的记录数。例如，要返回七个用户（不管林中有多少用户），请包含 ResultSize 参数，并将参数值设置为 7。请注意，无法保证返回哪七个用户。如果将 ResultSize 设置为 7，但是林中仅有三个用户，则此命令将返回这三个用户，操作完成，并且不生成错误。 结果大小可以设置为 0 到 2147483647（包含边界值）之间的任意整数。如果设置为 0，命令将运行，但是不会返回任何数据。 |
输入类型
字符串。Get-CsUserAcp 接受通过管道传递的字符串值，代表已启用 Lync Server 2010 的用户账户的标识。
返回类型
Get-CsUserAcp 返回 Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsUserAcp
示例 1 中显示的命令返回组织中所有用户的音频会议提供商信息。
-------------------------- 示例 2 --------------------------
Get-CsUserAcp -Identity "Ken Myer"
上述命令返回单个用户的音频会议提供商信息：Identity 为 Ken Myer 的用户。在此示例中，使用用户的 Active Directory 显示名称来指定标识。
-------------------------- 示例 3 --------------------------
Get-CsUserAcp -Filter {AcpInfo -ne $Null}
示例 3 返回至少已分配有一个音频会议提供商的所有用户的信息。为执行此操作，包含带有筛选器值 AcpInfo –ne $Null 的 Filter 参数，此筛选器值将返回数据限制为 AcpInfo 属性值不等于空值的用户。要返回有关尚未分配音频会议提供商的用户的信息，请使用以下筛选器值：
{AcpInfo –eq $Null}
-------------------------- 示例 4 --------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"
上述命令返回已分配有音频会议提供商 Fabrikam ACP 的任何用户的音频会议提供商信息。为完成此任务，此命令首先使用不带任何参数的 Get-CsUserAcp，以返回组织中所有用户的音频会议提供商信息。然后，将此信息通过管道传递到 Where-Object cmdlet，后者将挑选出 AcpInfo 属性包含 (-match) 字符串值“Fabrikam ACP”的任何用户。
-------------------------- 示例 5 --------------------------
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo
在示例 5 中，显示有关分配给用户 Ken Myer 的音频会议提供商的详细信息。为执行此操作，首先调用 Get-CsUserAcp 返回 Ken Myer 的音频会议提供商信息。然后，将此数据通过管道传递到 Select-Object cmdlet，后者使用 ExpandProperty 参数“展开”AcpInfo 属性的值。展开某个属性值时，意味着以易于阅读的方式显示存储在该值中的所有信息。