Get-CsAudioTestServiceApplication
上一次修改主题： 2012-03-23
允许您返回有关组织内使用的音频测试服务应用程序的信息。
语法
Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
详细说明
通过音频测试服务，Microsoft Lync 2010 用户可以在发出语音呼叫前测试语音连接。为执行此操作，用户单击“Lync 2010 选项”对话框的“音频设备”选项卡上的“检查呼叫质量”按钮。用户单击此按钮时，将向自动音频测试服务发出呼叫。此呼叫将得到应答，在播放介绍性提示后，系统将要求呼叫者录制简短消息。然后将重播该录音，使呼叫者可以听到他/她在当前连接中的声音状态。
音频测试服务部分依赖于 Active Directory 联系人对象。安装 Audio Bot 时会自动为您创建这些对象；无法手动创建这些对象。但是，管理员可以使用 Get-CsAudioTestServiceApplication cmdlet 检索有关组织内当前正在使用的各种测试服务联系人的信息。管理员还可以使用 Set-CsAudioTestServiceApplication 修改这些联系人的属性。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsAudioTestServiceApplication cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAudioTestServiceApplication"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
用户 ID 参数 |
音频测试服务联系人的 SIP 地址。 |
Credential |
可选 |
PS 凭据对象 |
使您可以通过备用凭据运行此 cmdlet。如果您登录 Windows 时所使用的帐户没有使用联系人对象所需的必要权限，则可能需要使用该对象。 要使用 Credential 参数，必须首先通过 Get-Credential cmdlet 创建 PSCredential 对象。有关详细信息，请参阅 Get-Credential cmdlet 帮助主题。 |
DomainController |
可选 |
FQDN |
使您可以连接到指定的域控制器，以便检索联系人信息。要连接到特定的域控制器，请包含 DomainController 参数，后跟计算机名称（例如 atl-cs-001）或其完全限定域名 (FQDN)（例如 atl-cs-001.litwareinc.com）。 |
Filter |
可选 |
字符串 |
用于通过筛选特定于 Lync Server 2010 的属性来限制返回的数据。例如，可以将返回的数据限制为具有特定显示名称或使用特定语言的音频测试联系人对象。 Filter 参数与 Where-Object cmdlet 使用相同的 Windows PowerShell 筛选语法。例如，仅返回显示名称为 Audio Test Service Contacts 的联系人的筛选器如下所示，其中 DisplayName 代表 Active Directory 属性，-eq 代表比较运算符（等于），“Audio Test Service Contacts”代表筛选器值： -Filter {DisplayName -eq "Audio Test Service Contact"} 不能在同一个命令中同时使用 Filter 和 Identity 参数。 |
OU |
可选 |
Active Directory 可分辨名称 |
使您可以返回特定 Active Directory 组织单位 (OU) 中的联系人。OU 参数返回来自指定 OU 及其任何子 OU 的数据。例如，如果 Finance OU 有两个子 OU（例如 AccountsPayable 和 AccountsReceivable），则将从这三个 OU 返回用户。 指定 OU 时，请使用此容器的可分辨名称 (DN)，例如：-OU "OU=Finance,dc=litwareinc,dc=com"。 |
ResultSize |
可选 |
整数 |
使您可以限制命令返回的记录数。例如，要返回七个用户（不管林中有多少用户），请包含 ResultSize 参数，并将参数值设置为 7。请注意，无法保证返回哪七个用户。如果将 ResultSize 设置为 7，但是林中仅有三个用户，则此命令将返回这三个用户，操作完成，并且不生成错误。 结果大小可以设置为 0 到 2147483647 之间（包含边界值）的任意整数。如果设置为 0，命令将运行，但是不会返回任何数据。 |
输入类型
无。
返回类型
Get-CsAudioTestServiceApplication 返回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAudioTestServiceApplication
上述示例中，调用不带任何其他参数的 Get-CsAudioTestServiceApplication，以便返回组织内当前正在使用的所有音频测试服务联系人的集合。
-------------------------- 示例 2 --------------------------
Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"
在示例 2 中，返回的是单个音频测试服务联系人：即 Identity 为 sip:RedmondAudioTest@litwareinc.com 的联系人。
-------------------------- 示例 3 --------------------------
Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}
示例 3 返回显示名称中包含字符串值“Redmond”的所有音频测试服务联系人。为执行此操作，该命令使用 Filter 参数和筛选器值 {DisplayName –like "*Redmond*"}；该筛选器值将返回的数据限制为显示名称中包含字符串值“Redmond”的联系人。该命令返回显示名称为“Redmond Audio Test Service Contact”、“Redmond Audio Bot”和“Test Contact for Redmond”等的联系人。