Set-CsConferencingConfiguration
上一次修改主题: 2012-04-23
修改现有的会议配置设置集合。会议设置可确定诸如会议内容和讲义允许的最大大小、内容宽限期(即内容在被删除前存储的时间)以及用于内部和外部下载支持的客户端的 URL 等信息。
语法
Set-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>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsConferencingConfiguration [-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>] [-Instance <PSObject>] [-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 来完成。在创建这些自定义设置后,您可以使用 Set-CsConferencingConfiguration cmdlet 修改其中的任何设置(或修改全局集合)。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsConferencingConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsConferencingConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的会议配置设置集合的唯一标识符。要引用全局集合,请使用以下语法:-Identity global。要引用在 site 作用域配置的集合,请使用以下类似语法:-Identity "site:Redmond"。要在 service 作用域引用集合,请使用以下类似语法:-Identity "service:ConferencingServer:atl-cs-001.litwareinc.com"。 Web 会议服务是唯一可以托管这些配置设置的服务。 如果未指定此参数,则 Set-CsConferencingConfiguration 将自动修改全局设置。 |
Instance |
可选 |
ConfSettings 对象 |
允许您将对对象的引用传递到 cmdlet,而不是设置单个参数值。 |
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,则以下三个端口可用于客户端音频: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,则以下 3 个端口可用于 SIP 流量: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 MB。 |
Organization |
可选 |
字符串 |
主持会议的组织的名称。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings 对象。 Set-CsConferencingConfiguration 接受通过管道传递的会议配置对象的实例。
返回类型
Set-CsConferencingConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings 对象的实例。
示例
示例 1
Set-CsConferencingConfiguration -Identity global -Organization Litwareinc
在示例 1 中, Set-CsConferencingConfiguration 修改会议配置设置的全局实例;在此示例中,该命令将 Organization 属性的值设置为 Litwareinc。这是通过包括 Organization 参数并后跟以下组织名称实现的:Litwareinc。
示例 2
Get-CsConferencingConfiguration | Set-CsConferencingConfiguration -Organization Litwareinc
示例 2 是第一个示例的扩展;在此示例中,该命令为当前使用的每一个会议配置设置集合修改 Organization 属性的值。为执行此操作,该命令首先使用 Get-CsConferencingConfiguration 检索所有会议配置设置的集合。然后,将该集合通过管道传递到 Set-CsConferencingConfiguration,后者会选取集合中的每一项,并将 Organization 属性的值更改为 Litwareinc。
示例 3
Get-CsConferencingConfiguration -Filter site:* | Set-CsConferencingConfiguration -MaxContentStorageMb 50
示例 3 中显示的命令为在 site 作用域应用的所有会议配置设置更改 MaxContentStorageMb 属性的值。为执行此操作,该命令首先调用带有 Filter 参数的 Get-CsConferencingConfiguration;筛选器值"site:*"可确保仅返回 Identity 以字符"site:"开头的。然后,将筛选出的集合通过管道传递到 Set-CsConferencingConfiguration,后者会将集合中每一项的 MaxContentStorageMb 属性值更改为 50。
示例 4
Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMb -gt 100} | Set-CsConferencingConfiguration -MaxContentStorageMB 100
在示例 4 中,将修改允许存储内容超过 100 MB 的所有会议配置设置,以便将允许的最大内容存储设置为 100 MB。为了执行此任务,该命令首先调用不带任何参数的 Get-CsConferencingConfiguration,以返回当前使用的所有会议配置设置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会挑选 MaxContentStorageMb 属性大于 100 的设置。接下来,将筛选出的集合通过管道传递到 Set-CsConferencingConfiguration,后者会接受集合中的每一项,并将 MaxContentStorageMb 属性的值设置为 100。
示例 5
Set-CsConferencingConfiguration -Identity site:Redmond -ContentGracePeriod "22:00:00"
上述命令检索 Redmond 站点 (-Identity site:Redmond) 的会议配置设置,修改 ContentGracePeriod 属性的值,并将宽限期设置为 22 小时(22 小时:00 分钟:00 秒)的设置。
示例 6
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Fabrikam"} | Set-CsConferencingConfiguration -Organization Litwareinc
在示例 6 中,将修改未将 Fabrikam 作为组织列出的所有会议配置设置;特别是,所有这些设置均分配了 Litwareinc 作为新组织。为完成此任务,该命令首先调用不带任何参数的 Get-CsConferencingConfiguration;这将返回组织中当前使用的所有会议配置设置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会选择 Organization 属性不等于 (-ne) Fabrikam 的所有设置。然后,将筛选出的集合通过管道传递到 Set-CsConferencingConfiguration; Set-CsConferencingConfiguration 会选取集合中的每一项,并将 Organization 属性的值更改为 Litwareinc。