Set-CsCommonAreaPhone
上次修改主題的時間： 2012-03-27
修改由 Microsoft Lync Server 2010 管理的公用區電話的屬性值。公用區電話是位於建築物大廳、員工休息室內的電話，或其他由許多不同人使用的區域內的電話，用途也各異。
語法
Set-CsCommonAreaPhone -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
公用區電話是未與個別使用者相關聯的 IP 電話。公用區電話不是位於某個人的辦公室中，通常是位於建築物大廳、餐廳、員工休息室、會議室以及其他一群人可能聚集的地點。這對系統管理員而言是一個管理上的挑戰；這是因為在 Lync Server 2010 中使用的電話通常是靠各種語音原則和撥號對應表在維護，而原則和對應表是指派給個別使用者。公用區電話不會被指派個別使用者。
解決此難題的方法是，針對所有的公用區電話建立 Active Directory 連絡人物件 (使用 New-CsCommonAreaPhone 指令程式建立這些連絡人物件)。就像使用者帳戶一樣，可以指派原則和語音對應表給這些連絡人物件。這樣一來，您就能夠對公用區電話保持控制，即使這些電話與個別使用者無關聯。例如，如果不要讓人從公用區電話轉接或保留通話，唯一要做的就是建立禁止通話轉接和保留通話的語音原則，然後將原則指派給公用區電話。(或者，更正確的說法是指派給代表公用區電話的連絡人物件)。這個命令會指派語音原則 CommonAreaPhoneVoicePolicy 給您所有的公用區電話：
Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"
Set-CsCommonAreaPhone 指令程式可以用來修改與公用區電話關聯的連絡人物件的屬性。總而言之，您可以變更連絡人的 Active Directory 顯示名稱或與此電話關聯的線路統一資源識別項 (URI)。您也可以使用 Enabled 參數啟用和停用用於 Lync Server 2010 的帳戶。
此外，您可以使用 CsClientPolicy Cmdlet 設定公共區域電話的「公用辦公桌」功能。當電話設為公用辦公桌電話時，使用者可以使用其 Lync Server 認證登入電話。這可讓使用者輕鬆存取其連絡人，以及執行其他功能。如需詳細資訊，請參閱 Cmdlet Set-CsClientPolicy 的說明主題。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsCommonAreaPhone Cmdlet：RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission 指令程式，為特定站台或特定 Active Directory 組織單位 (OU) 指派執行此指令程式的權限。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCommonAreaPhone"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
User ID 參數 |
公用區電話的唯一識別碼。識別公用區電話要使用相關聯連絡人物件的 Active Directory 辨別名稱。根據預設，公用區電話使用全域唯一識別碼 (GUID) 作為其一般名稱；這表示電話的識別身分通常是像這樣：CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。因此，您可能會發現使用 Get-CsCommonAreaPhone 指令程式，然後將傳回的物件傳送到 Set-CsCommonAreaPhone，能夠更輕易地擷取公用區電話。 |
Enabled |
選用 |
字串 |
出是否已啟用 Lync Server 2010 的公用區電話連絡人物件。 如果使用 Enabled 參數來停用連絡人，則會保留與該帳戶相關聯的資訊 (包括指派的原則以及連絡人是否已啟用 Enterprise Voice、遠端呼叫控制，和/或語音信箱整合)。如果之後使用 Enabled 參數來重新啟用帳戶，將會還原相關聯的帳戶資訊。 |
Description |
選用 |
字串 |
讓您可以修改公用區電話的 Active Directory 描述屬性。這是一個為電話額外提供資訊的方法；例如，您可以提供資訊說明電話故障時要連絡的人。 |
DisplayName |
選用 |
字串 |
讓您可以修改公用區電話的 Active Directory 顯示名稱。 |
DisplayNumber |
選用 |
字串 |
在 Microsoft Lync 2010 中顯示的電話號碼。DisplayNumber 屬性可設為任何您偏好的格式，例如 1-800-555-1234、1-(800)-555-1234、1.800.555.1234 等。選擇顯示號碼時，請記住，此號碼只有經過正規化後才會顯示在公用區電話的顯示畫面上 (正規化是將號碼字串轉譯為標準電話號碼格式的程序)。設定顯示號碼時，如果使用的電話號碼格式沒有正規化規則，則公用區電話的顯示畫面會顯示 LineUri 屬性的值，而非 DisplayNumber 屬性的值。 |
DomainController |
選用 |
字串 |
可讓您連線至指定的網域控制站，以修改連絡人資訊。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-mcs-001) 或其完整網域名稱；例如：atl-mcs-001.litwareinc.com。 |
EnterpriseVoiceEnabled |
選用 |
布林值 |
指出是否為 Enterprise Voice 啟用公用區電話的連絡人物件，Enterprise Voice 是 Microsoft 提供的 Voice over Internet Protocol (VoIP) 解決方案。透過 Enterprise Voice，便可使用網際網路撥打電話，而非使用標準電話網路。 |
LineUri |
選用 |
字串 |
公用區電話的電話號碼。指定線路統一資源識別項 (URI) 時應該採用 E.164 格式，並在開頭加上 "TEL:"首碼。例如：TEL:+14255551297。任何分機號碼都應該新增至線路 URI 的尾端；例如：TEL:+14255551297; ext=51297。 |
SipAddress |
選用 |
SIP 位址 |
唯一識別碼讓公用區電話可以和 SIP 裝置通訊，如 Lync 2010。SIP 位址的開頭必須是前置字元 sip:。而且包含有效的 SIP 網域。例如：sip:bldg14lobby@litwareinc.com。 |
PassThru |
選用 |
切換參數 |
傳回代表一般區域電話的物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 物件。
傳回類型
根據預設，Set-CsCommonAreaPhone 不會傳回任何物件或值。但是，如果您包含 PassThru 參數，指令程式會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsCommonAreaPhone -Filter {LineUri -eq "tel:+14255556710"} | Set-CsCommonAreaPhone -DisplayName "Employee Lounge"
範例 1 會修改電話號碼為 1-425-555-6710 的公用區電話的 Active Directory 顯示名稱。為此，系統首先會使用 Filter 參數呼叫 Get-CsCommonAreaPhone；篩選值 {LineUri -eq "tel:+14255556710"} 將傳回的資料限制為 LineUri 屬性等於 +14255556710 的公用區電話。傳回的物件便會傳送到 Set-CsCommonAreaPhone，由其將 DisplayName 屬性的值設定為 "Employee Lounge"。
-------------------------- 範例 2 ------------------------
Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -Enabled $True
範例 2 所示的命令會啟用所有目前設定用於組織中的公用區電話。為了執行此作業，命令會呼叫 Get-CsCommonAreaPhone 且不使用任何參數，以便傳回所有公用區電話的集合。然後將這個集合傳送到 Set-CsCommonAreaPhone 指令程式，由其提取集合中的每一個項目並將 Enabled 屬性設為 True。
-------------------------- 範例 3 ------------------------
Get-CsCommonAreaPhone -Filter {Description -eq $Null} | Set-CsCommonAreaPhone -Description "Common area phone"
前面的命令會在所有 Description 屬性尚未指派值的公用區電話上新增一般描述。為達成此目的，會呼叫 Get-CsCommonAreaPhone 搭配 Filter 參數；篩選值 {Description -eq $Null} 可確保只傳回 Description 屬性等於 Null 值的公用區電話。接著將篩選後的集合傳送給 Set-CsCommonAreaPhone，這會指派一般描述 "Common area phone" 給集合中的每個項目。