New-CsTrustedApplicationPool
上一次修改主题: 2012-03-27
创建要包含托管受信任应用程序的计算机的新池。
语法
New-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-Registrar <String>] [-RequiresReplication <$true | $false>] [-Site <String>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
详细说明
建议将 Microsoft Lync Server 2010 部署中正在运行受信任应用程序的计算机添加到一个仅用于受信任应用程序的单独池中。但是,您可以将受信任应用程序计算机添加到同时用于其他用途的现有池中。如果拓扑中已存在这种池,则此 cmdlet 会创建与该池关联的外部服务(服务角色为 ExternalServer)。如果不存在这种池,则此 cmdlet 会创建该池以及对应的服务。(可以通过调用 Get-CsPool cmdlet 来查找所有现有池的列表。)
创建一个新的受信任应用程序池(新的外部服务)时,还会创建一个新的分配给该池的受信任应用程序计算机。默认情况下,将为该计算机分配与池相同的完全限定域名 (FQDN)。但是,您可以通过使用此 cmdlet 的 ComputerFqdn 参数指定您自己的 FQDN 值。如果打算向池中添加更多计算机,则必须指定一个与池的 FQDN 不同的 ComputerFqdn 值。要向池中添加更多计算机,请调用 New-CsTrustedApplicationComputer cmdlet。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsTrustedApplicationPool cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationPool"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
新池的 FQDN。请注意,虽然用于创建池的 Identity 值为池 FQDN,但将作为新池的 Identity 存储的值实际上是自动为该池生成的服务 ID。此处输入的 Identity 将保存为 PoolFqdn。 |
AppSharingPortCount |
可选 |
Uint16 |
端口范围中可用于应用程序共享连接的端口的数目。 默认值:0 |
AppSharingPortStart |
可选 |
UInt16 |
端口范围中可用于应用程序共享连接的第一个端口的编号。 |
AudioPortCount |
可选 |
UInt16 |
端口范围中可用于音频连接的端口的数目。 默认值:0 |
AudioPortStart |
可选 |
UInt16 |
端口范围中可用于音频连接的第一个端口的编号。 |
ComputerFqdn |
可选 |
FQDN |
创建一个受信任应用程序池时,将自动创建一个属于该池的受信任应用程序计算机。默认情况下,该计算机与池将具有相同的 FQDN。在此参数中输入值可以为计算机指定一个与池 FQDN 不同的 FQDN。如果打算向池中添加更多计算机,则必须为此参数输入一个与池 FQDN 不同的值。 |
OutboundOnly |
可选 |
布尔值 |
指定受信任应用程序是否可以启动与池中的服务器的连接。如果要由服务器而不是应用程序启动所有连接,请将该值设置为 True。 默认值:False |
Registrar |
可选 |
字符串 |
池的 Registrar 服务的服务 ID 或 FQDN。 请注意,尽管此参数是可选的,但如果您尝试创建一个新的受信任应用程序终结点(通过使用 New-CsTrustedApplicationEndpoint cmdlet),并将该终结点分配给不依赖于 Registrar 的池,您将会收到错误并且不会创建该终结点。此外,还无法删除未与 Registrar 关联的受信任应用程序池。 |
RequiresReplication |
可选 |
布尔值 |
确定是否需要复制此池。如果不需要复制,则将此值设置为 False。对于 Microsoft Outlook Web Access 和手动设置的应用程序,通常应将此参数设置为 False。 默认值:True |
Site |
可选 |
字符串 |
该池所在的站点的站点 ID。调用 Get-CsSite cmdlet 可检索站点的 SiteId 属性。请记住,必须使用站点的 SiteId 属性而不是 Identity。另请注意,SiteId 前不得有字符串“site:”,必须仅输入 SiteId。此外,尽管您输入通过 Get-CsSite 检索的 SiteId,但是新的受信任应用程序池的 SiteId 属性将包含站点 Identity。例如,如果站点的 SiteId 为 Main,且站点 Identity 为 site:Redmond1,则您必须在对 New-CsTrustedApplicationPool 的调用中输入 -Site Main,但是对 Get-CsTrustedApplicationPool 的后续调用会将 SiteId 显示为 site:Redmond1。 如果 Identity 中指定的池已存在,则不需要指定 Site。如果该池不存在,则必须指定此参数。 |
ThrottleAsServer |
可选 |
布尔值 |
将此参数设置为 false,可作为客户端控制池中的服务器与受信任应用程序之间的连接。与默认值 True 相比,这会对连接施加更多限制。如果设置为默认值 True,将作为服务器控制连接。控制连接就是对可以同时发生的事务数施加限制。 默认值:True |
TreatAsAuthenticated |
可选 |
布尔值 |
确定在受信任应用程序连接到池中的服务器时是否需要进行身份验证。如果您要求对受信任应用程序进行身份验证,请将此参数设置为 False。如果设置为默认值 True,则允许受信任应用程序进行连接(假设它们已经过身份验证)。 默认值:True |
VideoPortCount |
可选 |
UInt16 |
端口范围中可用于视频连接的端口的数目。 默认值:0 |
VideoPortStart |
可选 |
Uint16 |
端口范围中可用于视频连接的第一个端口的编号。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.Xds.DisplayExternalServer 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond
此示例创建一个 FQDN 为 TrustPool.litwareinc.com 的新池。我们使用 Identity 参数来指定新的 FQDN。然后,使用值为 pool0.litwareinc.com 的 Registrar 参数将新池与具有该 FQDN 的 Registrar 服务关联。最后,使用值为 Redmond 的 Site 参数指定该池将是 Redmond 站点的一部分。
请注意 Site 值即为 SiteId(通过调用 Get-CsSite 可检索该值)。但是,站点 Identity 将与新的受信任应用程序池存储在一起。例如,如果某站点的 Identity 为 site:Redmond1 且 SiteId 为 NA,则您必须在对 New-CsTrustedApplicationPool 的调用中使用 NA 作为 Site 参数的值。但是,如果之后要查找 NA 站点的所有受信任应用程序池,则应该在 where 子句中使用 Identity 值,如下所示:
Get-CsTrustedApplicationPool | Where-Object {$_.SiteId –eq "site:Redmond1"}
-------------------------- 示例 2 --------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Registrar:redmond.litwareinc.com -Site Redmond -ComputerFqdn AppServer.litwareinc.com
示例 2 与示例 1 相同,但不是为 Registrar 服务指定 FQDN,而是使用的服务 ID (Registrar:redmond.litwareinc.com)。此外,还为 ComputerFqdn 参数指定了值。创建池时,还会在该池中创建一个计算机。默认情况下,该计算机与池将具有相同的 FQDN。我们为该池中的计算机指定了一个不同的 FQDN,即 AppServer.litwareinc.com。