Set-CsUCPhoneConfiguration
上次修改主題的時間： 2012-03-26
讓您能夠修改 Microsoft Lync 2010 Phone Edition 的管理選項。這包括像是所需的安全性模式，以及是否應在一段指定的未運作期間之後自動鎖定電話等事項。
語法
Set-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]
Set-CsUCPhoneConfiguration [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]
詳細描述
Lync 2010 Phone Edition 代表電話與 Microsoft Lync 2010 合併。Lync 2010 Phone Edition 會使用功能如同 Voice over Internet Protocol (VoIP) 電話的特殊硬體 (亦即與 Lync 2010 相容的電話)。此外，此硬體也會充當類似 Lync 2010 的端點：您可以設定目前的狀態、檢查 Lync 2010 連絡人的狀態、搜尋新的連絡人，並執行許多其他您過去使用 Lync 2010 執行的作業。
CsUCPhoneConfiguration 指令程式能讓您使用組態設定，管理執行 Lync 2010 Phone Edition 的電話。例如， 您可以控制登入電話所使用的個人識別碼 (PIN) 長度下限，並可指定在電話未使用一段時間後，是否自動將電話鎖住。
整合通訊 (UC) 電話組態設定可套用於全域範圍或站台範圍。當您首次安裝 Lync Server 時，會在全域範圍建立與套用單一的 UC 電話組態設定集。但在此之後，您便可以隨時使用 New-CsUCPhoneConfiguration 指令程式建立會在站台範圍套用的設定集合。這可讓您針對每個個別站台獨特的需求，量身設定 UC 電話管理。
除了建立 UC 電話設定的新集合之外，您可以使用 Set-CsUCPhoneConfiguration 指令程式來修改現有集合的屬性值。例如，根據預設，會針對 UC 電話停用記錄。若要在通用層級上啟用記錄，您可以使用 Set-CsUCPhoneConfiguration，將通用集合的 LoggingLevel 屬性值變更為 True。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsUCPhoneConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUCPhoneConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
代表要指派給 UC 電話組態設定集合的唯一識別碼。若要參照通用設定，請使用此語法：-Identity global。若要參考在站台範圍設定的集合，請使用如下的語法：-Identity site:Redmond。請注意，指定 Identity 時不能使用萬用字元。 如果省略此參數，則 Set-CsUCPhoneConfiguration 將修改通用設定。 |
Instance |
選用 |
UcPhoneSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
CalendarPollInterval |
選用 |
TimeSpan |
指出 UC 裝置每隔多久會從您的 Microsoft Outlook 行事曆擷取資訊。指定此值時必須使用這個格式 hours:minutes:seconds；例如，若要將時間間隔設為 1 小時 (所允許的間隔上限)，請使用這個語法：-CalendarPollInterval "01:00:00"。預設值為 3 分鐘 (00:03:00)。 |
EnforcePhoneLock |
選用 |
布林值 |
決定當經過 PhoneLockTimeout 指定的分鐘數後是否自動鎖住 UC 電話。預設值為 True。 |
LoggingLevel |
選用 |
字串 |
啟用 UC 裝置上的記錄功能。有效值為 Off、Low、Medium 與 High。預設值為 Off。 |
MinPhonePinLength |
選用 |
位元組 |
指定個人識別碼 (PIN) 所需的數字數目最小值。 最小值：4 最大值：15 預設值：6 |
PhoneLockTimeout |
選用 |
Timespan |
指定 UC 電話在閒置多久後 (單位為分鐘) 便會自動鎖住。 這個值必須小於 01:00:00 (1 小時)。預設值為 00:10:00 (10 分鐘)。 |
SIPSecurityMode |
選用 |
SIPSecurityMode |
指定伺服器套用到由 UC 電話所啟動之 SIP 工作階段的安全層級。 有效值為： Low (允許任何類型的授權或傳輸)。 Medium (需使用 NTLM 或 Kerberos 進行使用者驗證)。 High (需使用 NTLM 或 Kerberos 進行使用者驗證，並必須使用 TLS 進行 SIP 連線)。 預設值為 High。 |
Voice8021p |
選用 |
位元組 |
為 Lync Server 部署內的語音流量指定使用者優先順序值 (802.1p 值)。 只有在使用 802.1p 支援之交換器與橋接器的網路內，此設定才會生效。這個屬性的最小值是 0，最大值是 7，預設值是 0。 |
VoiceDiffServTag |
選用 |
位元組 |
指定 6 位元差異服務代碼點 (DSCP) 優先順序標記的十進位表示式。此表示式可為由此伺服器管理的 UC 電話所傳遞的 IP 封包定義個別躍點行為 (PHB)。 此值必須介於 0 到 63 (含) 之間。預設值為 40。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 物件。Set-CsUCPhoneConfiguration 會接受 UC 電話設定物件的管線執行個體。
傳回類型
Set-CsUCPhoneConfiguration 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsUCPhoneConfiguration -Identity global -SIPSecurityMode "Medium"
範例 1 所示的命令會將通用 UC 電話設定的 SIP 安全性模式設定為 Medium。
-------------------------- 範例 2 --------------------------
Set-CsUCPhoneConfiguration -Identity site:Redmond -PhoneLockTimeout "00:30:00"
上述命令會修改已針對 Redmond 站台設定的 UC 電話設定。在此案例中，PhoneLockTimeout 屬性已設定為 30 分鐘；作法是加上 PhoneLockTimeout 參數和參數值 "00:30:00" (00 小時:30 分鐘：00 秒) 的 A/V Edge 組態設定。
-------------------------- 範例 3 --------------------------
Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"
範例 3 是範例 2 所示命令的變化。但是，這次會針對站台範圍上設定的所有 UC 電話設定來修改 PhoneLockTimeout 屬性。為達成此目的，命令會先呼叫 Get-CsUCPhoneConfiguration；Filter 參數和篩選值 "site:*" 會將傳回的資料限制為站台範圍上所設定的電話設定。接著將此篩選過的集合傳送到 Set-CsUCPhoneConfiguration，以使用 PhoneLockTimeout 參數和參數值 "00:30:00" (00 小時:30 分鐘：00 秒)，將集合中每個項目的電話鎖定逾時值設定為 30 分鐘。
-------------------------- 範例 4 --------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Set-CsUCPhoneConfiguration -EnforcePhoneLock $True -PhoneLockTimeout "00:30:00"
上述命令會針對 SIP 安全性模式已設定為 Low 或 Medium 的所有 UC 電話設定，來設定 EnforcePhoneLock 和 PhoneLockTimeout 屬性。為了執行此工作，命令會先使用 Get-CsUCPhoneConfiguration 傳回組織中的所有 UC 電話組態設定；然後將此資訊傳送到 Where-Object 指令程式，此指令程式只挑出 SIPSecurityMode 屬性不等於 High 的設定 (因為 SIP 安全性可以設為 Low、Medium 或 High，這個子句會選取 SIPSecurityMode 設為 Low 或 Medium 的所有設定。)然後將篩選過的集合傳送到 Set-CsUCPhoneConfiguration，這會使用 EnforcePhoneLock 和 PhoneLockTimeout 參數來修改電話鎖定和電話鎖定逾時屬性。
-------------------------- 範例 5 --------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.PhoneLockTimeout -lt "00:10:00"} | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:10:00"
在範例 5 中，已針對 PhoneLockTimeout 屬性目前少於 10 分鐘的所有 UC 電話設定，將電話鎖定逾時值設定為 10 分鐘 (事實上，這樣會使得整個組織的電話鎖定逾時最小值變成 10 分鐘)。為達成此目的，命令會先使用 Get-CsUCPhoneConfiguration，來傳回組織目前所使用的所有 UC 電話設定集合。然後將此集合傳送到 Where-Object，這只會挑選出符合下列條件的設定：PhoneLockTimeout 屬性小於 10 分鐘 (00 小時:10 分鐘：00 秒) 的 A/V Edge 組態設定。然後，將此篩選過的集合傳送到 Set-CsUCPhoneConfiguration，這會將集合中每個項目的 PhoneLockTimeout 值設定為 10 分鐘。