Set-CsApplicationServer
上一次修改主题: 2012-03-27
能让您修改一个或多个运行应用程序服务的服务器的配置属性。这些服务器(也称为应用程序服务器)可托管使用 Microsoft 统一通信托管 API (UCMA) 集合开发的软件程序,如呼叫寄存应用程序。
语法
Set-CsApplicationServer [-Identity <XdsGlobalRelativeIdentity>] [-ApplicationDatabase <String>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AtsSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-CaaSipPort <UInt16>] [-CasSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-CpsSipPort <UInt16>] [-Force <SwitchParameter>] [-PdpSipPort <UInt16>] [-PdpTurnPort <UInt16>] [-Registrar <String>] [-RgsSipPort <UInt16>] [-RgsWcfMtlsPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
详细说明
应用程序服务可托管许多不属于核心服务器组件的 Microsoft Lync Server 2010 程序;这些程序包括响应组应用程序、会议助理应用程序和会议通知应用程序。应用程序服务选取这些程序,并将它们完全集成到 Lync Server 2010 环境中。
管理员可以借助 Set-CsApplicationServer cmdlet 来修改在其组织中部署的任何(或全部)应用程序服务器的配置设置。例如,可以修改用于音频、视频或应用程序共享通信的端口,或者将新值分配给由各个应用程序(如会议助理应用程序或会议通知应用程序)使用的端口。请注意,每次更改端口后,都需要重新启动对应的服务。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsApplicationServer cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsApplicationServer"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
要修改的应用程序服务器的服务位置。例如:-Identity "ApplicationServer:atl-cs-001.litwareinc.com"。 请注意,指定应用程序服务器时,在指定应用程序服务器时。例如:-Identity "atl-cs-001.litwareinc.com"。 |
ApplicationDatabase |
可选 |
字符串 |
应用程序数据库的服务位置。例如:-ApplicationDatabase "ApplicationDatabase:atl-cs-001.litwareinc.com"。 |
AppSharingPortCount |
可选 |
整数 |
分配用于应用程序共享的端口总数。要打开的实际端口将以为 AppSharingPortStart 配置的值开始,然后延续至为 AppSharingPortCount 指定的端口号。例如,如果将 AppSharingPortStart 设置为 60000,并将 AppSharingPortCount 设置为 100,那么会将端口 60000 至 60099 用于应用程序共享。 |
AppSharingPortStart |
可选 |
整数 |
分配用于应用程序共享的端口范围中的第一个端口。例如:–AppSharingPortStart 60000。 |
AtsSipPort |
可选 |
整数 |
用于音频测试服务的端口。 |
AudioPortCount |
可选 |
整数 |
分配用于发送和接收音频通信的端口总数。要打开的实际端口将以为 AudioPortStart 配置的值开始,然后延续至为 AudioPortCount 指定的端口号。例如,如果将 AudioPortStart 设置为 60000,并将 AudioPortCount 设置为 100,那么会将端口 60000 至 60099 用于音频通信。 |
AudioPortStart |
可选 |
整数 |
分配用于发送和接收音频通信的端口范围中的第一个端口。例如:–AudioPortStart 60000。 |
CaaSipPort |
可选 |
整数 |
会议助理应用程序使用的 SIP 端口,用于将用户连接到电话拨入式会议。 |
CasSipPort |
可选 |
整数 |
会议通知应用程序使用的 SIP 端口,用于在会议期间播放通知(例如,“Ken Myer 现在要退出”)。 |
CpsSipPort |
可选 |
整数 |
呼叫寄存服务使用的 SIP 端口。使用呼叫寄存服务,您可以通过一部电话将呼叫置于呼叫等待状态,然后从另一部电话中检索到该呼叫。 |
PdpSipPort |
可选 |
整数 |
策略决策点服务器使用的 SIP 端口。策略决策点 服务器用于带宽管理。 |
PdpTurnPort |
可选 |
整数 |
策略决策点 服务器使用的 TURN 通信端口。 |
Registrar |
可选 |
字符串 |
与策略决策点服务器关联的注册器的完全限定域名。 |
RgsSipPort |
可选 |
整数 |
响应组应用程序使用的 SIP 端口。响应组应用程序可将来电呼叫转至特定的人员组,如组织的支持团队。 |
RgsWcfMtlsPort |
可选 |
整数 |
用于由响应组应用程序使用的 Windows Communication Foundation (WCF) 相互 TLS (MTLS) 通信的端口。 |
VideoPortCount |
可选 |
整数 |
分配用于发送和接收视频通信的端口总数。要打开的实际端口将以为 VideoPortStart 配置的值开始,然后延续至为 VideoPortCount 指定的端口号。例如,如果将 VideoPortStart 设置为 60000,并将 VideoPortCount 设置为 100,那么会将端口 60000 至 60099 用于视频通信。 |
VideoPortStart |
可选 |
整数 |
分配用于发送和接收视频通信的端口范围中的第一个端口。例如 –VideoPortStart 60000。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsApplicationServer 不接受通过管道传递的输入。
返回类型
Set-CsApplicationServer 不会返回任何值或对象。此 cmdlet 会修改 Microsoft.Rtc.Management.Xds.DisplayApplicationServer 对象的现有实例。
示例
-------------------------- 示例 1 ------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -CasSipPort 5074
示例 1 中显示的命令在应用程序服务器 ApplicationServer:atl-cs-001.litwareinc.com 上将会议通知应用程序的 SIP 端口配置为 5074。
-------------------------- 示例 2 ------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -AudioPortStart 49500 -AudioPortCount 5500
上述命令配置用于应用程序服务器 ApplicationServer:atl-cs-001.litwareinc.com 的音频端口。在此示例中,起始的音频端口设置为 49500,为音频通信保留的端口共 5500 个。
-------------------------- 示例 3 ------------------------
Get-CsService -ApplicationServer | ForEach-Object {Set-CsApplicationServer -Identity $_.Identity -CasSipPort 5074}
在示例 3 中,对于组织中所有的应用程序服务器,用于会议通知应用程序的 SIP 端口设置为 5074。为此,该命令将首先使用 Get-CsService 返回当前正在使用的所有应用程序服务器的集合。然后,将该集合通过管道传递到 ForEach-Object cmdlet,后者将选取集合中的每台服务器,并使用 Set-CsApplicationServer 将会议通知应用程序 SIP 端口设置为 5074。