Remove-CsMeetingConfiguration

 

上一次修改主题: 2012-03-27

通过 Remove-CsMeetingConfiguration,您可以删除现有的会议配置设置集合。会议配置设置帮助规定用户可创建的会议类型,并控制(或即使是)匿名用户和电话拨入式会议用户加入这些会议的方式。

语法

Remove-CsMeetingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

详细说明

联机会议(也称为会议)是 Microsoft Lync Server 2010 必不可少的一部分。通过 CsMeetingConfiguration cmdlet,管理员可以控制用户可创建的会议类型,并决定会议如何对待匿名用户和电话拨入式会议用户。例如,可以配置会议,以便通过公用电话交换网 (PSTN) 拨入的任何用户将自动加入会议。或者,可以配置会议,以便拨入用户不会自动加入会议,而是路由到会议厅。这些拨入用户将在会议厅中处于等待状态,直到演示者允许他们加入会议。

会议配置设置可分配给 global、site 或 service 作用域。如果您在 site 或 service 作用域创建新设置,则稍后可使用 Remove-CsMeetingConfiguration cmdlet 删除这些设置。Remove-CsMeetingConfiguration 也可以针对全局会议设置运行。但是,在这种情况下,不会删除这些设置,这是因为不能删除全局设置。全局集合中的所有属性都将重置为其默认值。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsMeetingConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsMeetingConfiguration"}

参数

参数 必需 类型 描述

Identity

必需

Xds 标识

要删除的会议配置设置的唯一标识符。要“删除”全局设置,请使用以下语法:-Identity global。(如前所述,您实际上无法删除全局设置,只能将属性重置为其默认值。)要删除 site 作用域中的设置,请使用类似如下的语法:-Identity site:Redmond。可使用以下语法删除服务设置:-Identity service:UserServer:atl-cs-001.litwareinc.com。

请注意,在指定 Identity 时不能使用通配符。

Force

可选

开关参数

禁止显示运行此命令时可能出现的任何非严重错误消息。

Tenant

可选

GUID

此参数不用于 Lync Server 2010 的内部部署版本。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

开关参数

在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration 对象。Remove-CsMeetingConfiguration 接受通过管道传递的会议配置对象的实例。

返回类型

无。Remove-CsMeetingConfiguration 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration 对象的现有实例。

示例

-------------------------- 示例 1 --------------------------

Remove-CsMeetingConfiguration -Identity site:Redmond

在示例 1 中,删除 Identity 为 site:Redmond 的会议配置设置。从 Redmond 站点删除这些设置时,该站点中的用户将自动继承全局会议配置设置。

-------------------------- 示例 2 --------------------------

Get-CsMeetingConfiguration -Filter "site:*" | Remove-CsMeetingConfiguration

示例 2 中显示的命令删除在 site 作用域配置的所有会议设置。为执行此操作,该命令首先调用带有 Filter 参数的 Get-CsMeetingConfiguration,筛选器值“site:*”可确保仅选择 Identity 以字符“site:”开头的设置。然后,将筛选出的集合通过管道传递到 Remove-CsMeetingConfiguration cmdlet,后者将删除集合中的每一项。

-------------------------- 示例 3 --------------------------

Get-CsMeetingConfiguration | Where-Object {$_.AdmitAnonymousUsersByDefault -eq $True} | Remove-CsMeetingConfiguration

上述命令删除 AdmitAnonymousUsersbyDefault 属性为 True 的会议配置设置的每个集合。为完成此任务,该命令首先调用 Get-CsMeetingConfiguration,以返回当前正在使用中的所有会议配置设置的集合。然后,将该集合通过管道传递到 Where-Object,后者会仅挑选 AdmitAnonymousUsersByDefault 属性等于 True 的设置。然后,将筛选出的集合通过管道传递到 Remove-CsMeetingConfiguration,后者将继续删除该集合中的每一项。