Remove-CsDialInConferencingAccessNumber
上一次修改主题: 2012-03-25
删除现有的电话拨入式会议访问号码。电话拨入式会议为用户提供了一种使用“常规”电话或移动电话(即公用电话交换网 (PSTN) 上的设备)加入会议的音频部分的途径。
语法
Remove-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
电话拨入式会议允许用户使用任何类型的电话(例如,标准的“有线电话”、移动电话或 IP 语音电话等)加入会议的音频部分。这使得用户在没有计算机或 Internet 连接的情况下也能参加会议。用户具备完整的音频功能:他们能与其他与会者通话,并能听到所有内容。只是无法看到共享幻灯片、视频播放或其他可视元素
为了向用户提供电话拨入式会议功能,必须创建电话拨入式会议访问号码:用户可以进行呼叫以连接到会议的电话号码。电话拨入式会议访问号码是使用 New-CsDialInConferencingAccessNumber cmdlet 创建的。创建新的电话拨入式会议访问号码时,您实际上是在 Active Directory 域服务 (AD DS) 中创建了一个新的联系人对象;该联系人对象用于代表该访问号码及其所有属性。通过 Remove-CsDialInConferencingAccessNumber cmdlet,您可以删除任何使用 New-CsDialInConferencingAccessNumber 创建的电话拨入式会议号码。运行 Remove-CsDialInConferencingAccessNumber 时,此 cmdlet 不仅会删除电话拨入式会议访问号码集合中的号码,还会删除代表给定访问号码的 Active Directory 联系人对象。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsDialInConferencingAccessNumber cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDialInConferencingAccessNumber"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
SIP 地址 |
要删除的电话拨入式会议访问号码(即代表该号码的联系人对象)的 SIP 地址。指定 Identity 时,必须包含 sip: 前缀;例如:-Identity "sip:RedmondDialIn@litwareinc.com"。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Xds.AccessNumber 对象。Remove-CsDialInConferencingAccessNumber 接受通过管道传递的访问号码对象的输入。
返回类型
Remove-CsDialInConferencingAccessNumber 删除 Microsoft.Rtc.Management.Xds.AccessNumber 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com
示例 1 中显示的命令删除 Identity 为 sip:RedmondDialIn@litwareinc.com 的电话拨入式会议访问号码。
-------------------------- 示例 2 --------------------------
Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1800*"} | Remove-CsDialInConferencingAccessNumber
上述命令删除所有免费的电话拨入式会议访问号码;在此示例中,这意味着 LineUri 以“tel:+1800”开头的所有号码。为执行此操作,该命令使用 Get-CsDialInConferencingAccessNumber 和 Filter 参数返回配置为在组织中使用的所有免费访问号码的集合;筛选器值 {LineUri -like "tel:+1800*"} 将返回数据限制为 LineUri 属性以字符串值“tel:+1800”开头的号码。然后,将筛选出的集合通过管道传递到 Remove-CsDialInConferencingAccessNumber,后者将删除集合中的每一个号码。
-------------------------- 示例 3 --------------------------
Get-CsDialInConferencingAccessNumber -Region "Redmond" | Remove-CsDialInConferencingAccessNumber
在示例 3 中,删除 Redmond 地区的所有电话拨入式会议访问号码。为完成此任务,首先调用 Get-CsDialInConferencingAccessNumber 和 Region 参数以返回 Redmond 地区的所有访问号码的集合。(即在其地区列表中包含 Redmond 的任何访问号码。)然后,将该集合通过管道传递到 Remove-CsDialInConferencingAccessNumber,后者将删除集合中的所有访问号码。
-------------------------- 示例 4 --------------------------
Get-CsDialInConferencingAccessNumber -Region $Null | Remove-CsDialInConferencingAccessNumber
在示例 4 中,删除所有未与地区相关联的电话拨入式会议访问号码。为执行此操作,调用带有 Region 参数(参数值为 $Null)的 Get-CsDialInConferencingAccessNumber;这将返回 Regions 属性为空的访问号码的集合。然后,将该集合通过管道传递到 Remove-CsDialInConferencingAccessNumber,后者将删除该集合中的所有号码。
-------------------------- 示例 5 --------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "it-IT"} | Remove-CsDialInConferencingAccessNumber
示例 5 中显示的命令删除主要语言未设置为意大利语的任何电话拨入式会议访问号码。为执行此操作,首先调用不带任何参数的 Get-CsDialInConferencingAccessNumber,以返回配置为在组织中使用的所有电话拨入式会议访问号码的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者将挑选出 PrimaryLanguage 属性不等于意大利语(“it-IT”)的任何号码。最后,将筛选出的集合通过管道传递到 Remove-CsDialInConferencingAccessNumber,后者会删除集合中的所有访问号码。
-------------------------- 示例 6 --------------------------
Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default Dial-In Access Number"} | Remove-CsDialInConferencingAccessNumber
在示例 6 中,将删除显示名称为“Default Dial-In Access Number”的电话拨入式会议访问号码。为完成此任务,调用带有 Filter 参数且筛选器值为 {DisplayName -eq "Default Dial-In Access Number"} 的 Get-CsDialInConferencingAccessNumber;此筛选器值将返回的数据限制为 DisplayName 属性等于“Default Dial-In Access Number”的访问号码。然后将返回的对象通过管道传递到 Remove-CsDialInConferencingAccessNumber,后者将删除对应的访问号码。