Set-CsDialInConferencingDtmfConfiguration
上一次修改主题： 2012-03-27
修改用于电话拨入式会议的双音多频 (DTMF) 信号设置。通过 DTMF，拨号接入会议的用户可以使用其电话上的小键盘控制会议设置（例如，将自己静音和取消静音，或者锁定和解锁会议）。
语法
Set-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingDtmfConfiguration [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-Instance <PSObject>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]
详细说明
使用 Microsoft Lync Server 2010，用户可以通过电话拨入来加入会议。电话拨入用户无法查看视频，也无法与其他与会者交换即时消息，但他们可以完全参与会议的音频部分。
除了能够加入会议外，用户还可以使用其电话小键盘管理该会议的所选部分。（用户能否管理特定的会议设置取决于用户是否为演示者。）例如，默认情况下，用户可以按其小键盘上的 6 键将自己静音或取消静音。参与者可以私下播放所有其他与会者的姓名，而演示者可以执行的操作包括将所有与会者静音和取消静音，以及启用或禁用在每次有人加入会议或离开会议时播放的通知。
使用电话小键盘进行这种选择的功能称为双音多频 (DTMF) 信号：如果您曾经拨打过某个电话号码，并被要求按提示音“按 1 为英语，按 2 为西班牙语”进行操作，则您使用的就是 DTMF 信号功能。
通过 Set-CsDialInConferencingDtmfConfiguration cmdlet，您可以修改用于触发 Lync Server 2010 电话拨入式会议中支持的命令的键。
修改 DTMF 命令时，请记住两点。首先，只能使用数字键 0 到 9；不允许使用小键盘上可以找到的任何其他键（如 # 键）。该规则有一种例外情况：如果使用 CommandCharacter 参数，您就只能使用星号键 (*) 或井号键 (#)；不能将数字值分配给 CommandCharacter 参数。但是，所有其他命令参数只接受数字值。
第二，必须为命令分配唯一的键；例如，4 键不能同时用于将自己设置为静音/取消静音和锁定/解除锁定会议。这意味着在修改分配给命令的键时，您可能要交换两个不同命令使用的键。例如，如果要将 4 键分配给 EnableDisableAnnouncementsCommand（默认值：9） 应在同一个命令中将 9 键分配给 AudienceMuteCommand。
要禁用一个命令，请将其值设置为 Null ($Null)。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsDialInConferencingDtmfConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialInConferencingDtmfConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
指示要修改的 DTMF 设置集合的唯一标识符。要引用全局设置，请使用以下语法：-Identity global。要引用在 site 作用域配置的集合，请使用以下类似语法：-Identity site:Redmond。请注意，在指定 Identity 时不能使用通配符。 如果未指定此参数，则 Set-CsDialInConferencingDtmfConfiguration 将修改全局 DTMF 设置。 |
Instance |
可选 |
DialInConferencingDtmfConfiguration 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
AdmitAll |
可选 |
字符串 |
指示允许会议厅中的所有用户立即加入会议所按的键。默认值为 8。 |
AudienceMuteCommand |
可选 |
字符串 |
指示演示者要将会议中的所有其他人静音（也就是说，将除演示者外的每个人都静音）时可以按的键。默认键为 4。 |
CommandCharacter |
可选 |
字符串 |
指示命令开始时要按的键。默认键是星号键 (*)；唯一允许使用的其他值是井号键 (#)。 |
EnableDisableAnnouncementsCommand |
可选 |
字符串 |
指示每次有人加入或退出会议时启用或禁用通知所按的键。默认键为 9。 |
HelpCommand |
可选 |
字符串 |
指示私下对所有 DTMF 命令进行描述所按的键。默认键为 1。 |
LockUnlockConferenceCommand |
可选 |
字符串 |
指示锁定/解除锁定会议所按的键。如果锁定一个会议，将不允许新的参与者加入该会议，这种状态至少持续到解除锁定该会议。默认键为 7。 |
MuteUnmuteCommand |
可选 |
字符串 |
指示将自己设置为静音或取消静音时要按的键（使用相同的键在静音/取消静音间进行切换）。默认键为 6。 |
PrivateRollCallCommand |
可选 |
字符串 |
指示私下对每个与会者进行点名所按的键。默认键为 3。 |
Force |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
|
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 对象。Set-CsDialInConferencingDtmfConfiguration 接受通过管道传递的电话拨入式会议 DTMF 配置对象的实例。
返回类型
Set-CsDialInConferencingDtmfConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9
示例 1 中显示的命令交换分配给用于启用和禁用通告的命令的键（默认值为 9）和分配给用于将所有参与者静音和取消静音的命令的键（默认值为 4）。为此，使用了两个不同的参数：EnableDisableAnnoucementsCommand，其参数值指定为 4；以及 AudienceMuteCommand，其值指定为 9。由于未指定 Identity，因此这些更改将影响全局 DTMF 设置。
-------------------------- 示例 2 --------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9
示例 2 中显示的命令是第一个示例中显示的命令的变体。但在此示例中，更改只影响 Identity 为 site:Redmond 的 DTMF 设置。
-------------------------- 示例 3 --------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null
示例 3 中显示的命令禁用 Redmond 站点的点名命令（一种播放所有与会者名单的功能）。为了禁用此命令，包括了 PrivateRollCallCommand 参数并将其值设置为 $Null。这表示没有任何小键盘键与该命令关联，从而使该命令对用户不可用。
-------------------------- 示例 4 --------------------------
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null
示例 4 是示例 3 的变体：在此示例中，将对在 site 作用域配置的所有 DTMF 设置禁用点名命令。为执行此操作，该命令首先使用 Get-CsDialInConferencingDtmfConfiguration 和 Filter 参数返回在 site 作用域配置的所有设置的集合；筛选器值“site:*”将返回的数据限制为 Identity 以字符“site:”开头的设置。然后，将筛选出的集合通过管道传递到 Set-CsDialInConferencingDtmfConfiguration，后者会将 PrivateRollCallCommand 属性的值设置为空 ($Null)。