Set-CsAnalogDevice
上次修改主題的時間： 2012-03-26
修改類比裝置集合中可使用 Microsoft Lync Server 2010 管理的現有裝置。類比裝置是指和公用交換電話網路 (PSTN) 連接的電話或其他裝置。
語法
Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-Gateway <Fqdn>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
類比裝置包含電話、傳真機、數據機，以及與公用交換電話網路 (PSTN) 連接的聽障人士電傳通訊裝置 (TTY/TDD)。與利用 Enterprise Voice (亦即由 Microsoft 提供的 Voice over Internet Protocol (VoIP) 解決方案) 的裝置不同，類比裝置不會使用數位封包傳輸資訊，而是使用連續訊號來傳輸資訊。此訊號通常稱做類比訊號，因此這類裝置稱做「類比裝置」。
為了讓系統管理員能夠管理類比裝置，Lync Server 2010 讓您能夠將類比裝置與 Active Directory 連絡人物件產生關聯。在裝置已與連絡人物件產生關聯後，您便可藉由指派原則與撥號對應表至該連絡人，以管理類比裝置。
Set-CsAnalogDevice 指令程式讓您能夠修改與類比裝置相關聯連絡人物件的屬性。例如，您可以變更連絡人的 Active Directory 顯示名稱，或與裝置相關聯的線路統一資源識別項 (URI)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsAnalogDevice Cmdlet：RTCUniversalUserAdmins。您可以使用 Grant-CsOUPermission 指令程式，為特定的站台或特定的 Active Directory 組織單位 (OU) 指派執行此指令程式的權限。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAnalogDevice"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
User ID 參數 |
要修改之類比裝置的唯一識別碼。類比裝置使用關聯連絡人物件的 Active Directory 辨別名稱 (DN) 來識別。根據預設，類比裝置使用 GUID (全域唯一識別碼) 作為其一般名稱，這表示這些裝置通常具有類似如下的識別：CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。這表示您可能發現使用 Get-CsAnalogDevice Cmdlet 來傳回類比裝置物件後，再將其傳送到 Set-CsAnalogDevice 會是修改類比裝置的較簡單方式。 |
Gateway |
選用 |
字串 |
表示類比裝置使用之 PSTN 閘道的 IP 位址。 |
AnalogFax |
選用 |
布林值 |
如果類比裝置為傳真機則設為 True ($True)。如果裝置不是傳真機則設為 False ($False)。 |
LineURI |
選用 |
字串 |
類比裝置的電話號碼。指定線路 URI 時應該採用 E.164 格式，並在開頭加上 "TEL:"首碼。例如：TEL:+14255551297。任何分機號碼都應該新增至線路 URI 的尾端；例如：TEL:+14255551297; ext=51297。 |
SipAddress |
選用 |
SIP 位址 |
允許類比裝置與 SIP 裝置 (例如 Microsoft Lync 2010) 通訊的唯一識別碼。SIP 位址的開頭必須是首碼 "sip:"。例如：sip:bldg14lobby@litwareinc.com。 |
DisplayName |
選用 |
字串 |
設定類比裝置的 Active Directory 顯示名稱。 |
DisplayNumber |
選用 |
字串 |
在 Lync 2010 中顯示的電話號碼。DisplayNumber 屬性可設為任何您偏好的格式，例如 1-800-555-1234、1-(800)-555-1234、1.800.555.1234 等。 |
DomainController |
選用 |
切換參數 |
可讓您連線至指定的網域控制站，以修改連絡人資訊。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-mcs-001) 或其完整網域名稱 (FQDN) (例如，atl-mcs-001.litwareinc.com)。 |
Enabled |
選用 |
True |
設為 True ($True) 時，類比裝置可以搭配 Lync Server 2010 使用。 |
EnterpriseVoiceEnabled |
選用 |
布林值 |
指出是否已針對 Enterprise Voice 啟用類比裝置的連絡人物件；Enterprise Voice 是由 Microsoft 所提供的 VoIP 解決方案。透過 Enterprise Voice，便可使用網際網路撥打電話，而非使用標準電話網路。 |
PassThru |
選用 |
切換參數 |
傳回代表一般區域電話的物件。 |
WhatIf |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
|
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact 物件。Set-CsAnalogDevice 接受類比裝置物件管線傳送的執行個體。
傳回類型
Set-CsAnalogDevice 預設不會傳回任何物件或值。但是，如果您加上 PassThru 參數，指令程式將傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"
上述命令會針對 Identity 為 CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com 的類比裝置變更 LineUri 內容的值。
-------------------------- 範例 2 ------------------------
Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"
範例 2 所示的命令會變更每個目前使用 192.168.0.240 閘道的類比裝置閘道。為了執行這項工作，會呼叫 Get-CsAnalogDevice 並搭配 Filter 參數；篩選值 {Gateway -eq "192.168.0.240"} 可確保只傳回 Gateway 等於 (-eq) 192.168.0.240 的裝置。篩選後的集合便會傳送到 Set-CsAnalogDevice，這會取得集合中的每個項目，並將 Gateway 屬性的值變更為 192.168.1.100。