Get-CsConferencingPolicy

 

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

返回有关已配置为在组织中使用的会议策略的信息。会议策略决定了会议中可以使用的功能,从会议能否加入 IP 音频和视频到可参加会议的最大人数,涵盖会议的方方面面。

语法

Get-CsConferencingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsConferencingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

详细说明

会议功能是 Microsoft Lync Server 2010 的重要部分:通过会议,用户组可以共同联机查看幻灯片和视频、共享应用程序、交换文件以及进行其他形式的沟通和协作。

管理员要保持对会议和会议设置的控制,这一点非常重要。某些情况下,可能会有安全方面的顾虑:默认情况下,任何人,包括未通过身份验证的用户,都可以参加会议和保存这些会议期间分发的任何幻灯片或讲义。而在其他情况下,可能会有带宽方面的顾虑:同时举行多个会议,每个会议都有数百人参与,且都需要使用视频播放和文件共享功能,此时可能会使您的网络出现问题。另外,有时还可能有法律方面的顾虑。例如,默认情况下,会议参与者可以对共享内容进行注释,但在会议存档后不会保存这些注释。如果组织必须保存所有电子通信的记录,则您可能要禁用批注功能。

当然,需要管理会议设置是一回事,实际管理这些设置又是另外一回事。在 Lync Server 2010 中,使用会议策略管理会议。(在该软件的早期版本中,这些策略称为会议策略)。如前所述,会议策略可确定会议中可以使用的各种功能,从会议能否包括 IP 音频和视频,到能够参加会议的最大人数等全部内容都包含在内。会议策略可以在全局范围内、站点范围内或每用户范围内配置。这样管理员便可非常灵活地决定哪些用户可以使用哪些功能。

Get-CsConferencingPolicy cmdlet 提供了一种方法,用于返回有关已配置为在组织中使用的所有会议策略的信息。

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

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

参数

参数 必需 类型 描述

Identity

可选

Xds 标识

要检索的会议策略的唯一标识符。会议策略可以在全局、站点或每用户范围内配置。要检索全局策略,请使用此语法:-Identity global。要检索站点策略,请使用类似如下的语法:-Identity site:Redmond。要检索每用户策略,请使用类似如下的语法:-Identity SalesConferencingPolicy。

如果不加入此参数,则 Get-CsConferencingPolicy 将返回所有配置为在组织中使用的会议策略的集合。

请注意,指定 Identity 时不允许使用通配符。如果在指定会议策略时需要使用通配符,请使用 Filter 参数。

Filter

可选

字符串

使您可以在指定要返回的会议策略时使用通配符。例如,此语法返回在站点范围内配置的所有策略:-Filter "site:*"。要返回在每用户作用域内配置的所有策略的集合,请使用此语法:-Filter "tag:*"。

LocalStore

可选

开关参数

从中央管理存储的本地副本,而不是从中央管理存储本身检索会议策略数据。

输入类型

无。Get-CsConferencingPolicy 不接受通过管道传递的输入。

返回类型

Get-CsConferencingPolicy 返回 Microsoft.Rtc.Management.WritableConfig.Settings.Meeting.MeetingPolicy 对象的实例。

示例

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

Get-CsConferencingPolicy

上述示例返回配置为在组织中使用的所有会议策略的集合。

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

Get-CsConferencingPolicy -Identity Global

示例 2 中使用 Identity 参数将检索的信息限定为 Identity 等于 Global 的会议策略。由于策略的 Identity 必须唯一,因此该命令只返回一个策略:即 Global 会议策略。

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

Get-CsConferencingPolicy -Filter tag:*

上面的示例使用 Filter 参数返回在每用户作用域内配置的所有会议策略的集合。通配符值“tag:*”指示 Windows PowerShell 将返回的数据限定为 Identity 以字符串值“tag:”开头的会议策略。

-------------------------- 示例 4 --------------------------

Get-CsConferencingPolicy | Where-Object {$_.MaxMeetingSize -gt 100}

示例 4 返回 MaxMeetingSize 属性大于 100 的所有会议策略的集合。该命令首先使用 Get-CsConferencingPolicy cmdlet 返回所有配置为在组织中使用的会议策略的集合。然后,将该集合通过管道传递给 Where-Object cmdlet,后者应用一个筛选器,将返回的数据限定为 MaxMeetingSize 属性大于 100 的策略。

-------------------------- 示例 5 --------------------------

Get-CsConferencingPolicy | Where-Object {$_.AllowExternalUsersToSaveContent -eq $True -and $_.AllowExternalUserControl -eq $True}

上述命令返回符合以下两个条件的所有会议策略:AllowExternalUsersToSaveContent 属性等于 True,并且 AllowExternalUserControl 属性也等于 True。为此,该命令调用了不带任何其他参数的 Get-CsConferencingPolicy,这样将返回所有配置为在组织中使用的会议策略的集合。然后,将此集合通过管道传递给 Where-Object,后者仅挑选出 AllowExternalUsersToSaveContent 和 AllowExternalUserControl 均为 True 的那些策略。-and 运算符指示 Where-Object,要返回的对象必须符合所有指定条件。

-------------------------- 示例 6 --------------------------

Get-CsConferencingPolicy | Where-Object {$_.AllowExternalUsersToSaveContent -eq $True -or $_.AllowExternalUserControl -eq $True}

示例 6 是示例 5 所示命令的一种变体。在此例中,命令返回至少符合一个指定条件(但不必两个条件都符合)的所有策略:AllowExternalUsersToSaveContent 属性等于 True 和/或 AllowExternalUserControl 属性等于 True。为此,该命令调用了不带任何其他参数的 Get-CsConferencingPolicy,这样将返回所有配置为在组织中使用的会议策略的集合。然后,将此集合通过管道传递给 Where-Object,后者仅挑选出 AllowExternalUsersToSaveContent 和/或 AllowExternalUserControl 等于 True 的那些策略。-or 运算符指示 Where-Object,要返回的对象只要符合一个指定条件即可。