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 使用可充当 IP 电话 (VoIP) 电话的特殊硬件，即与 Lync 2010 兼容的电话。此外，该硬件还可充当与 Lync 2010 类似的终结点：您可以设置当前状态、查看 Lync 2010 联系人的状态、搜索新的联系人，以及执行您习惯于使用 Lync 2010 执行的许多其他活动。
通过 CsUCPhoneConfiguration cmdlet，您可以使用配置设置来管理运行 Lync 2010 Phone Edition 的电话。例如，您可以控制用于登录到电话的个人标识号 (PIN) 的最小长度，以及在经过指定的非活动期之后是否自动锁定电话等内容。
统一通信 (UC) 电话配置设置可在 global 作用域或 site 作用域应用。首次安装 Lync Server 时，将在 global 作用域创建并应用一组 UC 电话配置设置。但是，您可以在此之后的任何时间使用 New-CsUCPhoneConfiguration cmdlet 创建在 site 作用域应用的设置集合。这样，就可以根据各个站点的独特需求量身定制 UC 电话管理。
除了创建 UC 电话设置的新集合之外，还可以使用 Set-CsUCPhoneConfiguration cmdlet 修改现有集合的属性值。例如，默认情况下禁用 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。要引用在 site 作用域配置的集合，请使用以下类似语法：-Identity site:Redmond。请注意，在指定 Identity 时不能使用通配符。 如果省略此参数，Set-CsUCPhoneConfiguration 将修改全局设置。 |
Instance |
可选 |
UC 电话设置对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
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 部署中的语音流量指定用户优先级值（即 802.1p 值）。 此设置仅对交换机和网桥支持 802.1p 的网络有效。此属性的最小值为 0，最大值为 7。默认值为 0。 |
VoiceDiffServTag |
可选 |
字节 |
指定 6 位 DiffServ 代码点 (DSCP) 优先级标记的十进制表示形式。该标记定义此服务器管理的 UC 电话所传递的 IP 数据包的每跳行为 (PHB)。 该值必须介于 0 到 63（包含边界值）之间。默认值为 40。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 对象。Set-CsUCPhoneConfiguration 接受通过管道传递的 UC 电话设置对象的实例。
返回类型
Set-CsUCPhoneConfiguration 不会返回值或对象。此 cmdlet 会配置 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 秒）来实现的30 分钟:。
-------------------------- 示例 3 --------------------------
Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"
示例 3 是示例 2 中显示的命令的变体。但在此示例中，将修改所有在 site 作用域配置的 UC 电话设置的 PhoneLockTimeout 属性。为执行此操作，该命令首先调用 Get-CsUCPhoneConfiguration，Filter 参数和筛选器值“site:*”将返回的数据限制为在 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 cmdlet，后者将仅挑选出 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 秒）的设置。接下来，将筛选出的集合通过管道传递到 Set-CsUCPhoneConfiguration，后者将集合中每一项的 PhoneLockTimeout 值设置为 10 分钟。