New-CsUCPhoneConfiguration
上次修改主題的時間： 2012-03-26
建立用來管理 Microsoft Lync 2010 Phone Edition 的新設定集合。這些設定可讓您設定如必要安全模式等項目，並可指定在電話未使用一段時間後，是否自動將電話鎖住。
語法
New-CsUCPhoneConfiguration -Identity <XdsIdentity> [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 執行的作業。
Lync Server 2010 隨附許多指令程式可供您管理執行 Lync 2010 的電話；例如，您可以控制登入電話所使用的個人識別碼 (PIN) 長度下限，以及電話在未使用一段時間後是否會自動自行鎖住。
整合通訊 (UC) 電話組態設定可套用於全域範圍或站台範圍。(在站台範圍套用的設定優先於在通用範圍套用的設定)。當您首次安裝 Lync Server 時，會在全域範圍建立與套用單一的 UC 電話組態設定集。但在此之後，您便可以隨時使用 New-CsUCPhoneConfiguration 指令程式建立會在站台範圍套用的設定集合。這可讓您針對每個個別站台獨特的需求，量身設定 UC 電話管理。
New-CsUCPhoneConfiguration 可讓您在站台範圍建立新的 UC 電話設定。請注意，每個站台只能有一個設定集合。例如，如果您嘗試建立 Identity 為 site:Redmond 的設定集合，但是已經有一個 UC 電話設定集指派給 Redmond 網站。在這種情況下，您的命令會失敗。而您必須採取以下兩個步驟之一：移除現有設定，然後使用 New-CsUCPhoneConfiguration 建立新的設定集合；或只要者使用 Set-CsUCPhoneConfiguration 修改現有的設定。
您無法在全域範圍建立新的設定集合。您在全域範圍唯一能做的動作就是使用 Set-CsUCPhoneConfiguration 修改現有的設定。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsUCPhoneConfiguration Cmdlet：RTCUniversalServerAdmins。執行 Windows PowerShell 提示字元提供的下列命令，即可傳回指派給此指令程式 (包括您自行建立的任何自訂 RBAC 角色) 的所有角色存取控制 (RBAC) 角色清單：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUCPhoneConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
代表指派給新 UC 電話組態設定集合的唯一識別碼。由於您只能在站台範圍建立新集合，因此，Identity 一律是首碼 "site:"。後面接著站台名稱，例如 "site:Redmond"。 |
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 2010 部署內的語音流量指定使用者優先順序值 (802.1p 值)。 只有在使用 802.1p 支援之交換器與橋接器的網路內，此設定才會生效。這個屬性的最小值是 0，最大值是 7，預設值是 0。 |
VoiceDiffServTag |
選用 |
位元組 |
指定 6 位元差異服務代碼點 (DSCP) 優先順序標記的十進位表示式。此表示式可為由此伺服器管理的 UC 電話所傳遞的 IP 封包定義個別躍點行為 (PHB)。 此值必須介於 0 到 63 (含) 之間。預設值為 40。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsUCPhoneConfiguration 不會接受管線傳送的輸入。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsUCPhoneConfiguration -Identity site:Redmond -CalendarPollInterval "00:10:00" -LoggingLevel "Medium"
上述命令會為 Redmond 站台建立新的 UC 電話設定集合。在此範例中包含了兩個選擇性參數以及一個必要參數 Identity：一個是 CalendarPollInterval，此參數會將行事曆輪詢時間設為每隔 10 分鐘 (00 小時：10 分鐘：00 秒)；另一個是 LoggingLevel，此參數會將 UC 電話記錄層次設為 Medium。只要此命令一完成，新的設定便會套用到 Redmond 站台，且該站台的使用者會讓新的設定管理其 UC 電話。請注意，如果 Redmond 站台已有 UC 電話設定的集合，則此命令會失敗。
-------------------------- 範例 2 ------------------------
$x = New-CsUCPhoneConfiguration -Identity site:Redmond -InMemory
$x.CalendarPollInterval = "00:10:00"
$x.LoggingLevel = "Medium"
Set-CsUCPhoneConfiguration -Instance $x
範例 2 示範 InMemory 參數的使用方式，此參數可讓您建立僅存在於記憶體中的新 UC 電話設定集(這些設定儲存在 $x 變數中)。在建立此虛擬集合後，您可以使用類似範例中第二行與第三行的命令來修改僅於記憶體中的設定：在第二行中，CalendarPollInterval 屬性設為 10 分鐘 (00 hours:10 minutes:00 seconds)，而在第三行中，LoggingLevel 屬性會設為 Medium。
在您將屬性值修改完成後，便可以使用 Set-CsUCPhoneConfiguration 將儲存在 $x 中的虛擬設定轉變為實際套用到 Redmond 站台的設定集合。請注意，使用 InMemory 參數時，您必須呼叫 Set-CsUCPhoneConfiguration，系統才會真正套用設定。如果您未呼叫此指令程式，當終止 Windows PowerShell 工作階段或刪除變數 $x 時，您的虛擬設定便會消失。