[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>]]

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.)