Retrieves settings for one or more pools that contain the computers that host trusted applications.
Syntax
Get-CsTrustedApplicationPool [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>] |
Get-CsTrustedApplicationPool [-Filter <String>] [-PoolFqdn <String>] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Optional |
XdsGlobalRelativeIdentity |
The fully qualified domain name (FQDN) or service ID of the pool whose settings you want to retrieve. |
|
Filter |
Optional |
String |
A string containing one or more wildcard characters that is used to search for a pool with an Identity (service ID) that matches the wildcard string. For example, specifying the string Redmond* would retrieve all trusted application pools with service IDs beginning with the string Redmond, such as Redmond-ExternalApplication-1 and Redmond-ExternalApplication-2. |
|
PoolFqdn |
Optional |
String |
The FQDN of the pool you want to retrieve. This behaves the same as the Identity parameter, except that Identity also accepts a service ID. |
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, which defines that pool as a trusted application pool. This cmdlet retrieves one or more pools that have been defined as trusted application pools.
Return Types
Retrieves one or more objects of type Microsoft.Rtc.Management.Xds.DisplayExternalServer.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Get-CsTrustedApplicationPool |
|
Example 1 retrieves all pools within the Communications Server deployment that have been defined as trusted application pools.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Get-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com |
|
In this example, we’ve used the Identity parameter to ensure we retrieve only one trusted application pool, in this case the pool with the FQDN TrustPool.litwareinc.com.
-------------------------- Example 3 ------------------------
| Copy Code |
|
|---|---|
Get-CsTrustedApplicationPool -Filter Redmond-ExternalServer* |
|
This example retrieves all trusted application pools defined on the Redmond site. The Filter parameter is used with a value of Redmond-ExternalServer*. This filter string will search the Identity values of all trusted application pools for those that begin with the string Redmond-ExternalServer and end with any set of characters. For example, this command will retrieve pools with service IDs of Redmond-ExternalServer-1, Redmond-ExternalServer-2, and so on.
-------------------------- Example 4 ------------------------
| Copy Code |
|
|---|---|
Get-CsTrustedApplicationPool | Where-Object {$_.PoolFqdn -like "Trust*"
|
|
The Filter parameter searches only on Identity, which in the case of trusted application pools is the service ID. This example searches for pools based on FQDN. The example begins by calling Get-CsTrustedApplicationPool with no parameters, which retrieves a collection of all trusted application pools. This collection is then piped to the Where-Object cmdlet, which narrows down the collection to only those pools where the PoolFqdn ($_.PoolFqdn) matches the wildcard string (-like) Trust*. The result will be a collection of all trusted application pools with FQDNs beginning with the string Trust, such as TrustPool.litwareinc.com, TrustedApps.litwareinc.com, and TrustedPools.contoso.com.