Set-CsAudioTestServiceApplication
上一次修改主题： 2012-03-27
使您可以修改组织中当前正在使用的任何音频测试服务应用程序联系人的属性值。
语法
Set-CsAudioTestServiceApplication -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-CSEnabled <$true | $false>] [-DisplayName <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-WhatIf [<SwitchParameter>]]
详细说明
通过音频测试服务，Microsoft Lync 2010 用户可以在发出语音呼叫前测试语音连接。为执行此操作，用户单击“Lync 2010 选项”对话框的“音频设备”选项卡上的“检查呼叫质量”按钮。用户单击此按钮时，将向自动音频测试服务发出呼叫。该服务将应答呼叫，在播放介绍性提示后，系统将要求呼叫者录制简短消息（最多 10 秒）。然后将重播该录音，使呼叫者可以听到他/她在当前连接中的声音状态。
音频测试服务部分依赖于 Active Directory 联系人对象。安装 Audio Bot 时会自动为您创建这些对象；无法手动创建这些对象。但是，管理员可以使用 Get-CsAudioTestServiceApplication cmdlet 检索有关组织内当前正在使用的各种测试服务联系人的信息。管理员还可以使用 Set-CsAudioTestServiceApplication 修改这些联系人的属性。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权运行 Set-CsAudioTestServiceApplication cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAudioTestServiceApplication"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户 ID 参数 |
要修改的音频测试服务联系人的 SIP 地址。 |
Enabled |
可选 |
布尔值 |
指示此联系人对象是否已启用 Lync Server 2010。如果将此值设置为 False ($False)，联系人将无法再登录 Lync Server；如果将此值设置为 True ($True)，则可以重新启用联系人的登录权限。 |
DisplayName |
可选 |
字符串 |
联系人对象的 Active Directory 显示名称。 |
DisplayNumber |
可选 |
字符串 |
虽然 DisplayNumber 是有效属性，但它实际上不与音频测试服务一起使用。 |
EnabledForFederation |
可选 |
布尔值 |
指示此联系人是否对来自联盟域的用户可用。如果设置为 False，则只有组织中的用户有权访问该联系人。 |
EnterpriseVoiceEnabled |
可选 |
布尔值 |
指示联系人对象是否已启用企业语音，即 IP 电话 (VoIP) 的 Microsoft 实现。通过企业语音，用户可以使用 Internet 发出电话呼叫，而不是使用标准电话网络。 |
LineUri |
可选 |
字符串 |
虽然 LineUri 是有效属性，但它实际上不与音频测试服务一起使用。 |
PrimaryLanguage |
可选 |
字符串 |
用于音频测试服务的主要语言。必须使用一种允许的语言代码配置该语言；例如，en-US（表示美国英语）、fr-FR（表示法语）等。要返回可用语言代码的列表，请在 Windows PowerShell 提示符处键入以下命令： Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages。 |
SecondaryLanguages |
可选 |
字符串数组 |
虽然 SecondaryLanguages 是有效属性，但它实际上不与音频测试服务一起使用。 |
SipAddress |
可选 |
SIP 地址 |
允许联系人对象使用 SIP 设备（例如 Lync 2010）进行通信的唯一标识符。SIP 地址必须以 sip: 开头，例如：-SipAddress "sip:kenmyer@litwareinc.com"。 |
Type |
可选 |
字符串 |
指示部署的测试联系人的类型。默认情况下，将联系人列为 Automaton，这意味着他们可以与呼叫者进行相互交流。 |
PassThru |
可选 |
开关参数 |
使您可以通过管道传递用户对象，该用户对象表示要分配策略的用户。默认情况下，Set-CsAudioTestServiceApplication cmdlet 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Set-CsAudioTestServiceApplication 接受通过管道传递的 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 对象的实例。
返回类型
Set-CsAudioTestServiceApplication 不会返回任何对象或值。
示例
-------------------------- 示例 1 --------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage "en-US"
在示例 1 中，将音频测试服务联系人 sip:RedmondAudioTest@litwareinc.com 的主要语言设置为美国英语 (en-US)。
-------------------------- 示例 2 --------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage $Null
上述示例清除音频测试服务联系人 sip:RedmondAudioTest@litwareinc.com 的 PrimaryLanguage 属性的值；这是通过包含 PrimaryLanguage 参数并将参数值设置为 $Null 实现的。
-------------------------- 示例 3 --------------------------
Get-CsAudioTestServiceApplication | Set-CsAudioTestServiceApplication -PrimaryLanguage "en-US"
在示例 3 中，将组织中使用的所有音频测试服务联系人配置为使用美国英语作为其主要语言。为执行此操作，首先调用了不带任何参数的 Get-CsAudioTestServiceApplication，以返回音频测试服务联系人的集合。然后，将该集合通过管道传递到 Set-CsAudioTestServiceApplication，后者将集合中每个联系人的 PrimaryLanguage 属性指定为美国英语 (en-Us)。