New-CsConferencingConfiguration
上一次修改主题: 2012-04-23
创建新的会议配置设置集合。会议设置可确定诸如会议内容和讲义允许的最大大小、内容宽限期(即内容在被删除前存储的时间)以及用于内部和外部下载支持的客户端的 URL 等信息。
语法
New-CsConferencingConfiguration -Identity <XdsIdentity> [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
详细说明
对于会议,由两个 cmdlet 集分开进行管理。如果您要管理用户可否执行的操作(例如,用户可否邀请匿名与会者加入会议,是否允许用户在会议中提供应用程序共享,或是否允许用户在会议中传输文件),则需要使用 CsConferencingPolicy cmdlet。
管理员还需要管理 Web 会议服务。例如,要求管理员能够执行诸如指定分配给单个会议的最大内容存储和指定自动删除会议内容之前的宽限期等操作。此外,还必须能够指定用于应用程序共享和文件传输等活动的端口。
可以使用 CsConferencingConfiguration cmdlet 管理后面的这些活动。通过这些 cmdlet,您可以管理实际服务器本身。CsConferencingConfiguration cmdlet(可应用于 global、site 和 service 作用域)不会用于指定用户是否可以在会议期间共享应用程序,但是,如果允许共享应用程序,则可通过这些 cmdlet 指示要用于该活动的端口。同样,通过这些 cmdlet,您也可以指定存储限制、有效期以及指向内部和外部 URL(用户可在其中获取会议帮助和资源)的指针等信息。
安装 Microsoft Lync Server 2010 后,系统会为您提供会议配置设置的单个集合(全局集合)。如果您需要为站点或服务创建自定义设置,则可以使用 New-CsConferencingConfiguration cmdlet 来完成。请注意,只能在 site 作用域或 service 作用域应用新设置;您无法创建新的会议配置设置全局集合。此外,站点和服务都不能托管多个设置集合。如果您尝试为 Redmond 站点创建新设置,而 Redmond 站点已托管一个会议配置设置集合,则命令将会失败。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsConferencingConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsConferencingConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的会议配置设置集合的唯一标识符。要引用在 site 作用域配置的集合,请使用以下类似语法:-Identity "site:Redmond"。要在 service 作用域引用集合,请使用以下类似语法:-Identity "service:ConferencingServer:atl-cs-001.litwareinc.com"。请注意,Web 会议服务是唯一可以托管这些配置设置的服务。 |
ClientAppSharingPort |
可选 |
整数 |
代表用于应用程序共享的起始端口号。ClientAppSharingPort 的值必须是介于 1024 到 65535(包含边界值)之间的端口号。默认值为 5350。 |
ClientAppSharingPortRange |
可选 |
整数 |
表示应用程序共享的可用端口总数。(默认值为 40。)要确定用于应用程序共享的实际端口,请使用该值和 ClientAppSharingPort 值。例如,如果 ClientAppSharingPort 设置为 5350,ClientAppSharingPortRange 设置为 3,则以下 3 个端口可用于应用程序共享:5350、5351、5352。 |
ClientAudioPort |
可选 |
整数 |
代表用于客户端音频的起始端口号。ClientAudioPort 的值必须是介于 1024 到 65535(包含边界值)之间的端口号。默认值为 5350。 |
ClientAudioPortRange |
可选 |
整数 |
表示客户端音频的可用端口总数。(默认值为 40。)要确定用于客户端音频的实际端口,请使用该值和 ClientAudioPort 值。例如,如果 ClientAudioPort 设置为 5350,ClientAudioPortRange 设置为 3,则以下 3 个端口可用于客户端音频:5350、5351、5352。 |
ClientFileTransferPort |
可选 |
整数 |
代表用于文件传输的起始端口号。ClientFileTransferPort 的值必须是介于 1024 到 65535(包含边界值)之间的端口号。默认值为 5350。 |
ClientFileTransferPortRange |
可选 |
整数 |
表示文件传输的可用端口总数。(默认值为 40。)要确定用于文件传输的实际端口,请使用该值和 ClientFileTransferPort 值。例如,如果 ClientFileTransferPort 设置为 5350,ClientFileTransferPortRange 设置为 3,则以下三个端口可用于文件传输:5350、5351、5352。 |
ClientMediaPort |
可选 |
整数 |
代表用于客户端媒体的起始端口号。将此参数用于 Microsoft Office Communicator 2007 R2 客户端。ClientMediaPort 的值必须是介于 1024 到 65535(包含边界值)之间的端口号。默认值为 5350。 |
ClientMediaPortRange |
可选 |
整数 |
指示客户端媒体的可用端口总数。(默认值为 40。)将此参数用于 Office Communicator 2007 R2 客户端。要确定用于客户端媒体的实际端口,请使用该值和 ClientMediaPort 值。例如,如果 ClientMediaPort 设置为 5350,ClientMediaPortRange 设置为 3,则以下三个端口可用于客户端媒体:5350、5351、5352。 |
ClientMediaPortRangeEnabled |
可选 |
布尔值 |
设置为 True 时,客户端将使用为媒体流量指定的端口范围。设置为 False(默认值)时,任何可用端口(从端口 1024 到端口 65535)均可用于满足媒体流量的需要。 |
ClientSipDynamicPort |
可选 |
整数 |
代表用于 SIP 流量的起始端口号。ClientSipDynamicPort 的值必须是介于 1024 到 65535(包含边界值)之间的端口号。默认值为 7100。 |
ClientSipDynamicPortRange |
可选 |
整数 |
表示 SIP 流量的可用端口总数。(默认值为 3。)要确定用于 SIP 流量的实际端口,请使用该值和 ClientSipDynamicPort 值。例如,如果 ClientSipDynamicPort 设置为 7100,ClientSipDynamicPortRange 设置为 3,则以下三个端口可用于客户端媒体:7100、7101、7102。 |
ClientVideoPort |
可选 |
整数 |
代表用于客户端视频的起始端口号。ClientVideoPort 的值必须是介于 1024 到 65535(包含边界值)之间的端口号。默认值为 5350。 |
ClientVideoPortRange |
可选 |
整数 |
表示客户端视频的可用端口总数。(默认值为 40。)要确定用于客户端视频的实际端口,请使用该值和 ClientVideoPort 值。例如,如果 ClientVideoPort 设置为 5350,ClientVideoPortRange 设置为 3,则以下三个端口可用于客户端视频:5350、5351、5352。 |
ConsoleDownloadExternalUrl |
可选 |
字符串 |
外部用户可从中下载受支持客户端(如 Microsoft Lync 2010)的 URL。请注意,此设置仅适用于登录到 Lync Server 池的旧客户端(如 Microsoft Office Communicator 2007 R2)。 |
ConsoleDownloadInternalUrl |
可选 |
字符串 |
内部用户可从中下载受支持客户端(如 Microsoft Lync 2010)的 URL。请注意,此设置仅适用于登录到 Lync Server 池的旧客户端(如 Microsoft Office Communicator 2007 R2)。 |
ContentGracePeriod |
可选 |
TimeSpan |
指示在会议结束后会议内容将保留在服务器上的时间。必须使用格式 Days.Hours:Minutes:Seconds 来指定 ContentGracePeriod。例如,要将内容宽限期设置为 30 天,请使用以下语法:-ContentGracePeriod 30.00:00:00。 内容宽限期可设置为 30 分钟 (00:30:00) 到 180 天 (180.00:00:00) 之间的任意值。默认值为 15 天 (15.00:00:00)。 |
HelpdeskExternalUrl |
可选 |
字符串 |
会议期间单击“帮助”的外部用户将被定向到的 URL。 |
HelpdeskInternalUrl |
可选 |
字符串 |
会议期间单击“帮助”的内部用户将被定向到的 URL。 |
MaxBandwidthPerAppSharingServiceMb |
可选 |
整数 |
指示为应用程序共享会议服务预留的最大带宽量 (MB)。MaxBandwidthPerAppSharingServiceMb 可以设置为 50 到 100000(包含边界值)之间的任意整数值。默认值为 375 MB。 |
MaxContentStorageMb |
可选 |
整数 |
允许存储会议内容的最大文件空间量 (MB)。MaxContentStorageMb 可以设置为 50 到 1024 (1 GB)(包含边界值)之间的任意整数值。默认值为 500。 |
Organization |
可选 |
字符串 |
主持会议的组织的名称。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsConferencingConfiguration 不接受通过管道传递的输入。
返回类型
New-CsConferencingConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc
上述命令为 Redmond 站点 (site:Redmond) 创建新的会议配置设置集合。在此示例中,包括一个额外的参数 (Organization),该参数用于将 Organization 属性的值设置为 Litwareinc。请注意,如果 Redmond 站点已具有一个会议配置设置集合,此命令将失败。这是因为每个站点只能有一个这样的集合。
-------------------------- 示例 2 --------------------------
$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x
在示例 2 中,最初仅在内存中创建新的会议配置设置集合;这些虚拟设置后来才应用于 Redmond 站点。为执行此操作,示例中的第一个命令使用 New-CsConferencingConfiguration cmdlet 创建一个新的保存在内存中的设置集合,并存储在变量 $x 中;InMemory 参数指定应在内存中创建集合,而不立即将该集合应用于 Redmond 站点。
创建集合后,第二个命令将 Organization 属性的值设置为 Litwareinc。最后,第三个命令使用 Set-CsConferencingConfiguration 将新设置实际应用于 Redmond 站点。(如果会议配置设置已经应用于 site:Redmond,此命令将失败。)如果不调用 Set-CsConferencingConfiguration,新设置将永不生效。一旦结束 Windows PowerShell 会话或删除变量 $x,这些设置将立即消失。