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

Modifies a pool that contains the computers that host trusted applications.

Syntax

Set-CsTrustedApplicationPool [-Identity <XdsGlobalRelativeIdentity>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-RequiresReplication <$true | $false>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Identity

Required

XdsGlobalRelativeIdentity

The fully qualified domain name (FQDN) or service ID of the pool whose settings you want to modify.

Instance

Requried

PSObject

A reference to a trusted application pool object. This object, which must of type Microsoft.Rtc.Management.Xds.DisplayExternalServer, can be retrieved by calling the Get-CsTrustedApplicationPool cmdlet.

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.

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.

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.

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.

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.

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.

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.

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

WhatIf

Optional

SwitchParameter

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

Detailed Description

Trusted applications must be located on computers separate from the main Microsoft Communications Server 2010 deployment. These computers must be assigned to a pool that contains the service role ExternalServer. An external service pool can be created by calling the New-CsTrustedApplicationPool cmdlet. The Set-CsTrustedApplicationPool cmdlet modifies the settings for an existing trusted application pool. Note that you can’t modify the computers that are associated with a pool, you must use the CsTrustedApplicationComputer cmdlets to do that.

Return Types

This cmdlet does not return a value. It modifies an object of type Microsoft.Rtc.Management.Xds.DisplayExternalServer.

Examples

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

Copy Code
Set-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -OutboundOnly $True

This example modifies the pool with the FQDN TrustPool.litwareinc.com. We use the Identity parameter to specify the FQDN of the pool we want to modify. This example modifies the OutboundOnly property of the pool by specifying a value of True ($True) for the parameter OutboundOnly. (The default value is False.)