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 使用可充当 IP 电话 (VoIP) 电话的特殊硬件，即与 Lync 2010 兼容的电话。此外，该硬件还可充当与 Lync 2010 类似的终结点：您可以设置当前状态、查看 Lync 2010 联系人的状态、搜索新的联系人，以及执行您习惯于使用 Lync 2010 执行的许多其他活动。
Lync Server 2010 附带了许多可用于管理运行 Lync 2010 的电话的 cmdlet；例如，您可以控制用于登录到电话的个人标识号 (PIN) 的最小长度，以及在经过指定的非活动期之后是否将自动锁定电话等内容。
统一通信 (UC) 电话配置设置可在 global 作用域或 site 作用域应用。（在 site 作用域应用的设置优先于在 global 作用域应用的设置。）首次安装 Lync Server 时，将在 global 作用域创建并应用一组 UC 电话配置设置。但是，您可以在此之后的任何时间使用 New-CsUCPhoneConfiguration cmdlet 创建在 site 作用域应用的设置集合。这样，就可以根据各个站点的独特需求量身定制 UC 电话管理。
使用 New-CsUCPhoneConfiguration 可以在 site 作用域创建新的 UC 电话设置。请注意，每个站点只能有一个设置集合。例如，假设您试图创建 Identity 为 site:Redmond 的设置集合，但 Redmond 站点已分配有一组 UC 电话设置。在这种情况下，命令将会失败。您必须执行以下两个操作之一：删除现有设置并使用 New-CsUCPhoneConfiguration 创建新的设置集合；或者仅使用 Set-CsUCPhoneConfiguration 修改现有设置。
您不能在 global 作用域创建新的设置集合。可在 global 作用域执行的唯一操作是：使用 Set-CsUCPhoneConfiguration 修改现有设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsUCPhoneConfiguration cmdlet：RTCUniversalServerAdmins。要返回所有已分配此 cmdlet 的基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的所有自定义 RBAC 角色），请从 Windows PowerShell 提示符运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUCPhoneConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
表示要分配给新的 UC 电话配置设置集合的唯一标识符。由于您只能在 site 作用域中创建新集合，因此 Identity 将始终为前缀“site:”后跟站点名称；例如，“site:Redmond”。 |
CalendarPollInterval |
可选 |
TimeSpan |
指示 UC 设备从 Microsoft Outlook 日历中检索信息的频率。该值必须使用“小时:分钟:秒”格式指定；例如，要将时间间隔设置为 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 位 DiffServ 代码点 (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 中。）创建此虚拟集合之后，您可以使用本示例中第 2 行和第 3 行所显示的类似命令来修改这些仅保存在内存中的设置。在第 2 行中，CalendarPollInterval 属性设置为 10 分钟（00 小时:10 分钟:00 秒），在第 3 行中，LoggingLevel 属性设置为 Medium。
完成属性值修改之后，您就可以使用 Set-CsUCPhoneConfiguration 将 $x 中存储的虚拟设置转换为应用于 Redmond 站点的实际设置集合。请注意，使用 InMemory 参数时，在调用 Set-CsUCPhoneConfiguration 之前实际不会应用这些设置。如果未调用此 cmdlet，则虚拟设置将在您结束 Windows PowerShell 会话或删除变量 $x 时消失。