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 來擷取關於組織中目前使用之各種測試服務連絡人的資訊。系統管理員也可以使用 Set-CsAudioTestServiceApplication，來修改這些連絡人的內容。
誰可以執行這個指令程式：根據預設，會授權下列群組的成員執行 Set-CsAudioTestServiceApplication Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAudioTestServiceApplication"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserID 參數 |
要修改之音訊測試服務連絡人的 SIP 位址。 |
Enabled |
選用 |
布林值 |
表示是否已為 Lync Server 2010 啟用連絡人物件。如果您將此值設為 False ($False)，連絡人就無法再登入 Lync Server；將此值設為 True ($True) 可重新啟用連絡人的登入權限。 |
DisplayName |
選用 |
字串 |
連絡人物件的 Active Directory 顯示名稱。 |
DisplayNumber |
選用 |
字串 |
雖然是有效的內容，但是 DisplayNumber 實際上無法與音訊測試服務搭配使用。 |
EnabledForFederation |
選用 |
布林值 |
表示此連絡人是否可以用於同盟網域的使用者。若設定為 False，則只有您組織內的使用者具有該連絡人的存取權。 |
EnterpriseVoiceEnabled |
選用 |
布林值 |
表示連絡人物件是否已啟用 Enterprise Voice，這是 Microsoft 的 Voice over Internet Protocol (VoIP) 實作。透過 Enterprise Voice，使用者可以使用網際網路來撥打電話，而非使用標準電話網路。 |
LineUri |
選用 |
字串 |
雖然是有效的內容，但是 LineUri 實際上無法與音訊測試服務搭配使用。 |
PrimaryLanguage |
選用 |
字串 |
用於音訊測試服務的主要語言。您必須使用任一項允許的語言代碼來設定語言，例如，en-US 代表「英文 (美國)」、fr-FR 代表「法文」等。若要傳回可用的語言代碼清單，請在 Windows PowerShell 提示字元中輸入下列命令： Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages。 |
SecondaryLanguages |
選用 |
字串陣列 |
雖然是有效的內容，但是 SecondaryLanguages 實際上無法與音訊測試服務搭配使用。 |
SipAddress |
選用 |
SIP 位址 |
可讓連絡人物件使用像 Lync 2010 的 SIP 裝置進行通訊的唯一識別碼。SIP 位址的開頭必須加上 sip:，例如：-SipAddress "sip:kenmyer@litwareinc.com"。 |
Type |
選用 |
字串 |
表示要進行部署的測試連絡人類型。根據預設，將連絡人列為自動，這表示他們可以與來電者互動。 |
PassThru |
選用 |
切換參數 |
可讓您透過代表已指派原則的使用者之管線傳遞使用者物件。根據預設，Set-CsAudioTestServiceApplication 指令程式不會透過管線傳遞任何物件。 |
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，其會將「英文 (美國)」(en-Us) 指派給集合中每位連絡人的 PrimaryLanguage 內容。