New-CsMeetingConfiguration

 

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

在 site 或 service 作用域创建新的会议配置设置集合。除了控制匿名用户和电话拨入式会议用户如何(或即使)可以加入会议,会议配置设置还帮助规定用户可创建的会议类型。请注意,这些设置只影响预定的会议,而不影响通过单击 Microsoft Lync 中的“现在开会”选项创建的临时会议。

语法

New-CsMeetingConfiguration -Identity <XdsIdentity> [-AdmitAnonymousUsersByDefault <$true | $false>] [-AssignedConferenceTypeByDefault <$true | $false>] [-Confirm [<SwitchParameter>]] [-DesignateAsPresenter <None | Company | Everyone>] [-EnableAssignedConferenceType <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-PstnCallersBypassLobby <$true | $false>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

详细说明

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

如上所述,这些设置只影响预定的会议,而不影响通过单击 Microsoft Lync 中的“现在开会”创建的临时会议。当您通过单击“现在开会”创建会议时,会自动向所有人开放参与者访问权限,匿名用户无需在会议厅中等候即可加入会议。无论使用 CsMeetingConfiguration cmdlet 如何配置会议设置,都会出现这种情况。

使用 New-CsMeetingConfiguration cmdlet,您可以在 site 或 service 作用域内创建新的会议配置集合(尽管只适用于 User 服务)。您无法在 global 作用域内创建会议设置,因为全局会议设置集合已经存在。

注意,每个站点或服务最多只能有一个会议配置设置集合。如果您尝试为 Redmond 站点创建新设置,而 Redmond 站点已经有一个会议配置设置集合,那么命令将失败。

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

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

参数

参数 必需 类型 描述

Identity

必需

Xds 标识

新的会议配置设置集合的唯一标识符。您只能在站点范围或服务范围内创建会议配置设置。要在站点范围内创建新设置,请使用与此类似的语法:-Identity "site:Redmond"。要在服务范围内创建新设置,请使用类似语法:-Identity "service:UserServer:atl-cs-001.litwareinc.com"。

注意,如果指定的站点或服务已经有一个会议配置设置集合,则调用 New-CsMeetingConfiguration 将失败。

AdmitAnonymousUsersByDefault

可选

布尔值

决定是否默认允许匿名用户(即未经身份验证的用户)出席会议。如果希望在默认情况下允许匿名用户参加新会议,请将该值设置为 True。如果希望在默认情况下不允许匿名用户参加新会议,请将该值设置为 False。默认值为 True。

AssignedConferenceTypeByDefault

可选

布尔值

决定是否默认将新会议配置为公共会议。将该值设置为 True,则默认情况下使用公开会议;将该值设置为 False,则默认情况下使用私人会议。默认值为 True。

DesignateAsPresenter

可选

PS 列表修饰符

指示哪些用户(除了会议组织者)在加入会议时会自动指定为演示者。有效的选择包括:None、Company 和 Everyone。默认情况下,DesignateAsPresenter 设置为 Company,这意味着组织中的每个人在加入会议时都具有演示者权限。

EnableAssignedConferenceType

可选

布尔值

指示是否允许用户安排公共会议。对于公共会议,每次举行会议时,会议 ID 和会议链接都会保持一致。对于私人会议,会议 ID 和会议链接会随着会议的不同而发生变化。

PstnCallersBypassLobby

可选

布尔值

指示是否应自动允许通过公用电话交换网 (PSTN) 电话线路拨入的用户加入会议。如果此参数设置为 True,将自动允许 PSTN 呼叫者加入会议。如果此参数设置为 False,PSTN 呼叫者最初将被路由至会议厅。此时,他们需要等待,并处于呼叫等待状态,直到会议演示者授予他们参加会议的权限。默认值为 True。

Force

可选

开关参数

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

InMemory

可选

开关参数

创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。

Tenant

可选

全局唯一标识符

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

WhatIf

可选

开关参数

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

Confirm

可选

开关参数

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

输入类型

无。New-CsMeetingConfiguration 不接受通过管道传递的数据。

返回类型

New-CsMeetingConfiguration 创建新的 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration 对象实例。

示例

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

New-CsMeetingConfiguration -Identity site:Redmond -EnableAssignedConferenceType $False -AssignedConferenceTypeByDefault $False -AdmitAnonymousUsersByDefault $False

上述命令为 Redmond 站点 (-Identity site:Redmond) 创建一个新的会议配置设置集合。除了指定 Identity 外,此命令中还加入了三个可选参数:EnableAssignedConferenceType、AssignedConferenceTypeByDefault 和 AdmitAnonymousUsersByDefault。在所有三种情况下,这些参数都设置为 False。这意味着将禁用公共会议类型,默认的会议类型将不设置为公共会议,并且默认情况下将不允许匿名用户出席会议。

注意,如果存在 Identity 为 site:Redmond 的会议配置设置集合,则此命令将失败。这是因为给定站点只能应用一个会议配置设置集合。

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

$x = New-CsMeetingConfiguration -Identity site:Redmond -InMemory
$x.EnableAssignedConferenceType = $False 
$x.AssignedConferenceTypeByDefault = $False 
$x.AdmitAnonymousUsersByDefault = $False
Set-CsMeetingConfiguration -Instance $x

示例 2 介绍了一个为 Redmond 站点创建新的会议配置设置集合的备选方法;在此例中,初始时仅在内存中创建设置,随后才将这些设置应用于站点。为执行此操作,示例中的第一个命令使用 New-CsMeetingConfiguration 为 Redmond 站点创建新的会议设置。命令结尾添加了 InMemory 参数,以确保仅在内存中创建这些设置,并且不立即应用于 Redmond 站点。(由于这些设置只存在于内存中,因此必须将其存储在变量中。在此示例中,它们存储在一个名为 $x 的变量中。)

创建这些虚拟会议设置之后,使用命令 2、3 和 4 修改这些设置的属性(EnableAssignedConferenceType、AssignedConferenceTypeByDefault 和 AdmitAnonymousUsersByDefault)。在最后一个命令中,使用 Set-CsMeetingConfiguration 和 Instance 参数将虚拟设置真正应用于 Redmond 站点。注意,最后这一步至关重要:如果不调用 Set-CsMeetingConfiguration,新的会议配置设置将永远不会应用到 Redmond 站点。您的虚拟设置将在终止 Windows PowerShell 会话或删除变量 $x 后立即消失。