Remove-CsDialInConferencingDtmfConfiguration
上一次修改主题： 2012-03-26
删除现有的用于电话拨入式会议的双音多频 (DTMF) 信号设置的集合。通过 DTMF，拨号接入会议的用户可以使用其电话上的小键盘控制会议设置（例如，将自己静音和取消静音，或者锁定和解锁会议）。
语法
Remove-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
使用 Microsoft Lync Server 2010，用户可以通过电话拨入来加入会议。电话拨入用户无法查看视频，也无法与其他与会者交换即时消息，但他们可以完全参与会议的音频部分。
除了能够加入会议外，用户还可以使用其电话小键盘管理该会议的所选部分。（用户能否管理特定的会议设置取决于用户是否为演示者。）例如，默认情况下，用户可以按其小键盘上的 6 键将自己静音或取消静音。参与者可以私下播放所有其他与会者的姓名，而演示者可以执行的操作包括将所有与会者静音和取消静音，以及启用/禁用在每次有人加入会议或离开会议时播放的通知。
使用电话小键盘进行这种选择的功能称为双音多频 (DTMF) 信号：如果您曾经拨打过某个电话号码，并被要求按提示音“按 1 为英语，按 2 为西班牙语”进行操作，则您使用的就是 DTMF 信号功能。
安装 Lync Server 2010 时，将为您创建一个 DTMF 设置的全局集合。除了这些全局设置，还可以使用 New-CSDialInConferencingDtmfConfiguration cmdlet 基于站点创建自定义设置。在 site 作用域创建的设置随后可使用 Remove-CSDialInConferencingDtmfConfiguration cmdlet 删除。删除应用于 site 作用域的 DTMF 设置后，受影响站点中的用户会自动受全局 DTMF 配置设置的管辖。
您也可以针对全局设置运行 Remove-CSDialInConferencingDtmfConfiguration。但即使执行了此操作，全局设置也不会删除，因为您无法删除全局 DTMF 设置。而是会将全局设置中的属性重置为其默认值。例如，假设已修改全局设置，将 4 键作为静音/取消静音键。如果您现在针对全局设置运行 Remove-CSDialInConferencingDtmfConfiguration，则静音/取消静音键的值将重置为默认值 6。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsDialInConferencingDtmfConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDialInConferencingDtmfConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的 DTMF 设置集合的唯一标识符。要“删除”全局设置，请使用以下语法：-Identity global。（如前所述，您无法实际删除全局设置，您能做的是将属性重置为默认值。）要删除在 site 作用域配置的集合，请使用类似如下的语法：-Identity site:Redmond。指定 Identity 时，不能使用通配符。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 对象。Remove-CsDialInConferencingDtmfConfiguration 接受通过管道传递的电话拨入式会议 DTMF 配置对象的实例。
返回类型
无。Remove-CSDialInConferencingDtmfConfiguration 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CSDialInConferencingDtmfConfiguration -Identity site:Redmond
上述命令删除 Identity 为 site:Redmond 的 DTMF 配置设置集合。
-------------------------- 示例 2 --------------------------
Get-CSDialInConferencingDtmfConfiguration -Filter "site:*" | Remove-CSDialInConferencingDtmfConfiguration
示例 2 中显示的命令删除在 site 作用域配置的所有 DTMF 设置。为此，此命令首先使用 Get-CSDialInConferencingDtmfConfiguration 和 Filter 参数返回 site 作用域配置的所有 DTMF 设置的集合；筛选器值“site:*”可确保仅返回具有以字符串值“site:”开头的 Identity 的。然后，筛选出的集合通过管道传递到 Remove-CSDialInConferencingConfiguration，后者将删除此集合中的所有项。
-------------------------- 示例 3 --------------------------
Get-CSDialInConferencingDtmfConfiguration | Where-Object {$_.PrivateRollCallCommand -eq $Null} | Remove-CSDialInConferencingDtmfConfiguration
在示例 3 中，Remove-CSDialInConferencingDtmfConfiguration 用于删除 PrivateRollCallCommand 属性为空值的所有 DTMF 设置。（也即私人唱名命令已禁用。）为此，命令首先使用 Get-CSDialInConferencingDtmfConfiguration 返回组织中当前使用的所有 DTMF 设置的集合。然后，此集合通过管道传递到 Where-Object cmdlet，此 cmdlet 会仅选择 PrivateRollCallCommand 等于空值的设置。然后，将筛选出的集合通过管道传递到 Remove-CSDialInConferencingDtmfConfiguration，后者将删除集合中的每一项。