Retrieves information about one or more computers that host trusted applications.
Syntax
Get-CsTrustedApplicationComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>] |
Get-CsTrustedApplicationComputer [-Filter <String>] [-Pool <String>] |
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Optional |
XdsGlobalRelativeIdentity |
The fully qualified domain name (FQDN) of the computer you want to retrieve. |
Filter |
Optional |
String |
A string that includes wildcards that allows you to retrieve trusted computers based on Identity values that match the given wildcard string. |
Pool |
Optional |
String |
The FQDN of the trusted application pool for which you want to retrieve computer information. |
Detailed Description
Trusted applications run on separate computers from the rest of the Microsoft Communications Server 2010 deployment. These computers are also added to separate pools that contain computers that host trusted applications. (These pools can contain other computers, but it is recommended that you create separate pools for trusted application computers.) Use this cmdlet to retrieve the Identity (FQDN) and the pool on which it is located of one of more computers that contain trusted applications.
You can use this cmdlet to retrieve computers based on FQDN or to retrieve all the computers that are part of a specified pool.
Return Types
Retrieves one or more objects of type Microsoft.Rtc.Management.Xds.DisplayComputer.
Examples
-------------------------- Example 1 ------------------------
Copy Code | |
---|---|
Get-CsTrustedApplicationComputer |
Example 1 retrieves all computers that have been assigned to any trusted application pool within the Communications Server deployment.
-------------------------- Example 2 ------------------------
Copy Code | |
---|---|
Get-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com |
Example 2 retrieves information about the computer with the FQDN Trust1.litwareinc.com.
-------------------------- Example 3 ------------------------
Copy Code | |
---|---|
Get-CsTrustedApplicationComputer -Filter Trust* |
This example uses the Filter parameter to do a wildcard search for all computers that have an FQDN beginning with the characters Trust that have been assigned to trusted application pools. The Filter parameter searches the Identity property of all trusted application computers. The wildcard charater (*) at the end of the string means that the Filter should look for identities that begin with the string Trust followed by any other characters.
-------------------------- Example 4 ------------------------
Copy Code | |
---|---|
Get-CsTrustedApplicationComputer -Pool TrustPool.litwareinc.com |
Example 4 retrieves a list of all computers that have been assigned to the trusted application pool TrustPool.litwareinc.com.
-------------------------- Example 5 ------------------------
Copy Code | |
---|---|
Get-CsTrustedApplicationComputer | Where-Object {$_.Pool -like "*.litwareinc.com"} |
In Example 3 we used the Filter parameter to do a wildcard search based on Identity (the FQDN of the computer). In this example, we’re again doing a wildcard search, but this time on the Pool rather than the Identity. We first call Get-CsTrustedApplicationComputer to retrieve a collection of all the trusted application computers. We then pipe that collection to the Where-Object cmdlet. Where-Object allows us to narrow down the collection that has been piped to it. In this case we want to keep only the trusted application computers that are in any pool on the litwareinc.com domain. To do this we check the Pool property of each item in the collection ($_.Pool) and see if it matches (-like) the wildcard string *.litwareinc.com. A value will match that string if it begins with any set of characters and ends with the string .litwareinc.com.