[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Creates a new pool that will contain the computers that host trusted applications.

Syntax

New-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> -Registrar <String> [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-RequiresReplication <$true | $false>] [-Site <String>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Identity

Required

XdsGlobalRelativeIdentity

The FQDN of the new pool. Note that while the Identity value for creating a pool is the pool FQDN, the value that will be stored as the Identity with the new pool is actually an automatically generated service ID of the pool. The Identity entered here will be saved as the PoolFqdn.

Registrar

Required

String

The service ID or FQDN of the Registrar service for the pool.

Site

Optional

String

The name of the site on which this pool is homed. Enter only the name of the site; the string “site:” will be automatically prepended to the site name. For example, if you enter the site Redmond, the site named stored in the pool’s Site property will be site:Redmond.

If the pool specified in the Identity already exists you do not need to specify a Site. If the pool doesn’t exist, this parameter is required.

ThrottleAsServer

Optional

Boolean

Set this parameter to false to throttle connections between the servers within the pool and trusted applications as clients. This places greater restrictions on the connections than the default True, which throttles connections as servers. Throttling a connection simply places restrictions on the number of transactions that can occur at once.

Default: True

TreatAsAuthenticated

Optional

Boolean

Determines whether authentication is required for trusted applications connecting to servers within the pool. Set this parameter to False if you want to require trusted applications to be authenticated. The default value of True allows the trusted applications to connect under the assumption they’ve already been authenticated.

Default: True

OutboundOnly

Optional

Boolean

Specifies whether a trusted application can initiate a connection to a server within the pool. Set this value to True if you want all connections to be initiated by the server rather than the application.

Default: False

RequiresReplication

Optional

Boolean

Determines whether replication is required for this pool. Set this value to False if replication is not required. You would normally set this parameter to False for Outlook Web Access and manually-provisioned applications.

Default: True

AudioPortStart

Optional

UInt16

The number of the first port in the port range available for audio connections.

AudioPortCount

Optional

UInt16

The number of ports available in the port range for audio connections.

Default: 0

AppSharingPortStart

Optional

UInt16

The number of the first port in the port range available for application sharing connections.

AppSharingPortCount

Optional

Uint16

The number of ports available in the port range for application sharing connections.

Default: 0

VideoPortStart

Optional

Uint16

The number of the first port in the port range available for video connections.

VideoPortCount

Optional

UInt16

The number of ports available in the port range for video connections.

Default: 0

ComputerFqdn

Optional

FQDN

Creating a trusted application pool will automatically create a trusted application computer that is part of that pool. By default the computer will receive the same FQDN as the pool. Enter a value in this parameter to specify an FQDN for the computer that is different from the pool FQDN. If you plan to add more computers to the pool, you must enter a value for this parameter that is different from the pool FQDN.

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

InMemory

Optional

SwitchParameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

WhatIf

Optional

SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Detailed Description

It is recommended that the computers that are running trusted applications within a Microsoft Communications Server 2010 deployment be added to a separate pool that is only for trusted applications. However, you can add trusted application computers to an existing pool that is also used for other purposes. If the pool already exists as part of the topology this cmdlet creates the external service associated with that pool (with a service role of ExternalServer). If the pool does not exist, this cmdlet creates the pool and the corresponding service. (You can find a list of all existing pools by calling the Get-CsPool cmdlet.)

Creating a new trusted application pool (a new external service) also creates a new trusted application computer assigned to that pool. By default the computer will be assigned the same fully qualified domain name (FQDN) as the pool. However, you can specify your own value for the FQDN by using the ComputerFqdn parameter of this cmdlet. If you plan to add more computers to the pool, you must specify a ComputerFqdn value that is different from the FQDN of the pool. To add more computers to the pool, call the New-CsTrustedApplicationComputer cmdlet.

Return Types

Creates an object of type Microsoft.Rtc.Management.Xds.DisplayExternalServer.

Examples

-------------------------- Example 1 ------------------------

Copy Code
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond

This example creates a new pool with the FQDN TrustPool.litwareinc.com. We use the Identity parameter to specify the new FQDN. We use the Registrar parameter with a value of pool0.litwareinc.com to associate the new pool with the Registrar service at that FQDN. Finally, we use the Site parameter with a value of Redmond to specify that this pool will be part of the Redmond site.

-------------------------- Example 2 ------------------------

Copy Code
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Redmond-Registrar-1 -Site Redmond -ComputerFqdn AppServer.litwareinc.com

Example 2 is identical to Example 1 except that instead of specifying an FQDN for the Registrar service we’ve used the service ID, Redmond-Registrar-1. In addition, we’ve specified a value for the ComputerFqdn parameter. When a pool is created, a computer is also created within that pool. By default the computer will have the same FQDN as the pool. We’ve specified a different FQDN, AppServer.litwareinc.com, for the computer that is in this pool.