Remove-CsUCPhoneConfiguration
上一次修改主题： 2012-03-26
删除指定的一组 Microsoft Lync 2010 Phone Edition 配置设置。这些设置包括所需的安全模式以及是否应在指定的非活动时期后自动锁定电话等内容。
语法
Remove-CsUCPhoneConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Lync 2010 Phone Edition 表示电话和 Microsoft Lync 2010 的组合。Lync 2010 Phone Edition 使用可充当 IP 电话 (VoIP) 电话的特殊硬件，即与 Lync 2010 兼容的电话。此外，该硬件还可充当与 Lync 2010 类似的终结点：您可以设置当前状态、查看 Lync 2010 联系人的状态、搜索新的联系人，以及执行您习惯于使用 Lync 执行的许多其他活动。
Microsoft Lync Server 2010 附带了许多可用于管理运行 Lync 2010 的电话的 cmdlet；例如，您可以控制用于登录到电话的个人标识号 (PIN) 的最小长度，以及在经过指定的非活动期之后是否将自动锁定电话等内容。
统一通信 (UC) 电话配置设置可在 global 作用域或 site 作用域应用。（在站点范围内应用的设置优先于在全局范围内应用的设置。）首次安装 Lync Server 2010 时，将在 global 作用域创建并应用一组 UC 电话配置设置。但是，之后您可以随时使用 New-CsUCPhoneConfiguration cmdlet 创建在 site 作用域应用的设置集合。这样即可定制 UC 电话管理以满足每个站点的独特需要。
以后可使用 Remove-CsUCPhoneConfiguration cmdlet 删除使用 New-CsUCPhoneConfiguration 创建的设置。从站点中删除这些设置后，该站点中运行 Lync 2010 的电话不会处于无管理状态，而是会自动受到全局设置的管辖。
还可以对全局设置运行 Remove-CsUCPhoneConfiguration。但是，这样做不会真正地删除全局设置：不能删除全局 UC 电话设置。而是会将全局设置中的属性重置为其默认值。例如，如果已将电话锁定时间间隔更改为 30 分钟，则“删除”全局设置会将该间隔重置为 10 分钟这一默认值。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsUCPhoneConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUCPhoneConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的那组 UC 电话配置设置的唯一标识符。要删除站点集合，请使用类似于这种形式的语法：-Identity "site:Redmond"。要删除（重置）全局集合，请使用以下语法：-Identity global。注意，指定策略的 Identity 时不能使用通配符。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 对象。Remove-CsUCPhoneConfiguration 接受通过管道传递的 UC 电话设置对象的实例。
返回类型
无。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Remove-CsUCPhoneConfiguration -Identity site:Redmond
示例 1 中显示的命令删除 Redmond 站点 (-Identity site:Redmond) 的 UC 电话配置设置。从站点范围内删除设置后，该站点中的用户将由全局电话配置设置管理其 UC 电话。
-------------------------- 示例 2 ------------------------
Get-CsUCPhoneConfiguration -Filter site:* | Remove-CsUCPhoneConfiguration
示例 2 删除 site 作用域内已配置的所有 UC 电话设置。为此，该命令首先使用 Get-CsUCPhoneConfiguration 和 Filter 参数返回 site 作用域内配置的所有设置；筛选器值“site:*”将返回的数据限于 Identity 属性（唯一可筛选的属性）以字符串值“site:”开头的设置。然后，将筛选出的此集合通过管道传递给 Remove-CsUCPhoneConfiguration，后者将删除集合中的每项。
-------------------------- 示例 3 ------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False} | Remove-CsUCPhoneConfiguration
示例 3 中删除所有未施加电话锁定的 UC 电话设置。为完成此任务，该命令首先使用 Get-CsUCPhoneConfiguration（无任何参数）返回组织中当前正在使用的所有 UC 电话设置的集合。此集合将通过管道传递到 Where-Object cmdlet，后者仅选取 EnforceLockProperty 为 False 的设置。接下来，将这个筛选出的集合通过管道传递给 Remove-CsUCPhoneConfiguration，后者删除集合中的每项。
-------------------------- 示例 4 ------------------------
Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Remove-CsUCPhoneConfiguration
上述命令删除所有 SIP 安全模式设置为 Low 或 Medium 的 UC 电话配置设置。为此，首先调用 Get-CsUCPhoneConfiguration 以返回配置为在组织中使用的所有 UC 电话设置的集合。然后，将这个集合通过管道传递给 Where-Object，后者仅选择 SIPSecurityMode 属性设置为 Low 或 Medium 的那些设置；这一点通过选择 SIPSecurityMode 不等于 High 的那些设置得以实现。（SIPSecurityMode 可以采用以下三个值：Low、Medium 和 High。）然后，将筛选出的集合通过管道传递给 Remove-CsUCPhoneConfiguration，后者删除所有 SIPSecurityMode 不等于 High 的设置。