Set-CsUserAcp
上一次修改主题: 2012-03-27
向用户或用户组添加新的音频会议提供商,或修改已分配给用户的现有音频会议提供商。
语法
Set-CsUserAcp -Identity <UserIdParameter> -Domain <String> -Name <String> -ParticipantPasscode <String> -TollNumber <String> [-Confirm [<SwitchParameter>]] [-IsDefault <$true | $false>] [-PassThru <SwitchParameter>] [-TollFreeNumbers <String[]>] [-Url <String>] [-WhatIf [<SwitchParameter>]]
详细说明
音频会议提供商是为组织提供会议服务的第三方公司。音频会议提供商的功能之一是为外出且未连接到企业网络或 Internet 的用户提供了一种通过音频参加会议的方法。音频会议提供商通常会包括一些高端服务,如实时翻译、转录和每个会议的实时接线员协助。
Microsoft Lync Server 2010 不允许与音频会议提供商完全集成。通过 CsUserAcp cmdlet,管理员可以设置电话号码和密码,以及配置每次用户安排会议时都可用于音频会议提供商集成的其他信息。但是,由于这些 cmdlet 并非旨在用于 Lync Server 的内部版本(而是主要用于与 Microsoft Lync Online 2010 配合使用),因此除分配属性值外,未提供其他音频会议提供商集成。
可以使用 Set-CsUserAcp cmdlet 为用户帐户分配音频会议提供商。(请注意,可以为一个用户分配多个音频会议提供商。)也可以使用 Set-CsUserAcp 修改现有音频会议提供商的属性。如果调用 Set-CsUserAcp,则此 cmdlet 会使用调用中包含的参数信息检查分配给用户的现有音频会议提供商。如果找到匹配项,则将修改现有的提供商。例如,假设您发出以下命令:
Set-CsUserAcp –Identity "Ken Myer" –TollNumber "15554251298" –ParticipantPassCode 13761 –Domain "fabrikam.com" –Name "Fabrikam ACP"
再假设已为 Ken Myer 分配名为 Fabrikam ACP 的音频会议提供商,并且该提供商具有此命令中指定的 TollNumber 和 Domain。(换句话说,唯一的区别是 ParticipantPassCode。)在这种情况下,Set-CsUserAcp 会修改现有的 Fabrikam ACP 提供商。如果找不到匹配项,那么将向 Ken Myer 的用户帐户添加新的提供商。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsUserAcp cmdlet:RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserAcp"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
用户标识 |
指示要修改的用户帐户的标识。可以使用以下四种格式之一指定用户的标识:1) 用户的 SIP 地址;2) 用户的用户主体名称 (UPN);3) 用户的域名和登录名,格式为“域名\登录名”(如 litwareinc\kenmyer);以及 4) 用户的 Active Directory 域服务 (AD DS) 显示名称(例如 Ken Myer)。此外,还可以使用用户的 Active Directory 可分辨名称引用用户标识。 在使用显示名称作为用户标识时,可以使用通配符星号 (*)。例如,Identity "* Smith" 将返回显示名称以字符串值“ Smith”结尾的所有用户。 |
Domain |
必需 |
字符串 |
音频会议提供商的域名。例如:-Domain "fabrikam.com"。 |
Name |
必需 |
字符串 |
音频会议提供商的名称。例如:-Name "Fabrikam Conference Services"。 |
ParticipantPasscode |
必需 |
字符串 |
通过使用音频会议提供商连接到会议时所需的密码。例如:-PassCode "0712"。 |
TollNumber |
必需 |
字符串 |
用于音频会议的付费电话号码。例如:-TollNumber "14255551298"。 |
IsDefault |
可选 |
布尔值 |
指示这是否为用户的默认音频会议提供商。每个用户只能有一个默认提供商。 |
TollFreeNumbers |
可选 |
字符串 |
用于音频会议的免费电话号码的集合。例如:-TollFreeNumbers "18005551298"。要添加多个免费号码,请使用逗号分隔各个号码,如下所示:-TollFreeNumber "18005551298", "18005559876"。 |
Url |
可选 |
字符串 |
音频会议提供商的 Web URL;例如:-Url "http://acp.fabrikam.com"。通过 Web URL,音频会议提供商可将用户定向到包含其他拨入电话号码以及有关由音频会议提供商提供的服务信息的网页。 |
PassThru |
可选 |
开关参数 |
使您可以通过管道传递用户对象(代表已删除音频会议提供商的用户)。默认情况下,Set-CsUserAcp cmdlet 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Set-CsUserAcp 接受通过管道传递的代表已启用 Lync Server 2010 的用户帐户 Identity 的字符串值。该 cmdlet 还接受通过管道传递的 Active Directory 用户对象的实例。
返回类型
无。
示例
-------------------------- 示例 1 --------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
在示例 1 中,使用 Set-CsUserAcp 为用户 Ken Myer 分配新的音频会议提供商。为执行此操作,使用 Identity 参数指示要修改的用户帐户。此外,还包含带有相应参数值的必需参数 TollNumber、ParticipantPassCode、Domain 和 Name。
-------------------------- 示例 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUserAcp -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
示例 2 中显示的命令为在 Finance 部门工作的所有用户分配相同的音频会议提供商。为执行此操作,该命令首先使用 Get-CsUser 和 LdapFilter(带有筛选器值“Department=Finance”)返回在 Finance 部门工作的所有用户的集合。然后,将此集合通过管道传递到 Set-CsUserAcp cmdlet,后者会为集合中的每个用户分配相同的音频会议提供商 (Fabrikam ACP)。
-------------------------- 示例 3 --------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP" -TollFreeNumbers "18005551010", "18005551020"
上述命令为用户 Ken Myer 分配 Fabrikam ACP 音频会议提供商。除了指定 TollNumber、ParticipantPassCode、Domain 和 Name,此命令还包含一对免费电话号码。为分配这两个值,请包含 TollFreeNumbers 参数,后跟使用逗号分隔的两个电话号码。