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 來擷取關於組織中目前使用之各種測試服務連絡人的資訊。系統管理員也可以使用 Set-CsAudioTestServiceApplication，來修改這些連絡人的內容。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsAudioTestServiceApplication Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAudioTestServiceApplication"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
User ID 參數 |
音訊測試服務連絡人的 SIP 位址。 |
Credential |
選用 |
PS 認證物件 |
可讓您以替代認證來執行指令程式。如果您用來登入 Windows 的帳戶不具有使用連絡人物件所需的必要權限，可能就需要這一項。 若要使用 Credential 參數，您必須先使用 Get-Credential 指令程式建立 PSCredential 物件。如需詳細資料，請參閱 Get-Credential 指令程式說明主題。 |
DomainController |
選用 |
FQDN |
可讓您連線至指定的網域控制站，以擷取連絡人資訊。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-cs-001) 或其完整網域名稱 (FQDN) (例如，atl-cs-001.litwareinc.com)。 |
Filter |
選用 |
字串 |
可讓您篩選 Lync Server 2010 特定屬性來限制傳回的資料。例如，您可以將傳回的資料限制為擁有特定顯示名稱或使用特定語言的音訊測試連絡人物件。 Filter 參數使用的 Windows PowerShell 篩選語法與 Where-Object 指令程式相同。例如，只會傳回顯示名稱為「音訊測試服務連絡人」之連絡人的篩選看起來如下：DisplayName 代表 Active Directory 屬性；-eq 代表比較運算子 (等於)，而「音訊測試服務連絡人」代表篩選值： -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 傳回使用者。 指定 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"。