Get-CsTrustedApplicationComputer
Retrieves information about one or more computers that host trusted applications. This cmdlet was introduced in Lync Server 2010.
Syntax
Identity
Get-CsTrustedApplicationComputer
[[-Identity] <XdsGlobalRelativeIdentity>]
[-Pool <String>]
[-Local]
[<CommonParameters>]
Filter
Get-CsTrustedApplicationComputer
[-Filter <String>]
[-Pool <String>]
[-Local]
[<CommonParameters>]
Description
We recommend that the computers that are running trusted applications within a Skype for Business Server 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. 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 the computer FQDN or to retrieve all the computers that are part of a specified pool.
Examples
Example 1
Get-CsTrustedApplicationComputer
Example 1 retrieves all computers that have been assigned to any trusted application pool within the Skype for Business Server deployment.
Example 2 (Skype for Business Server 2015)
Get-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com
Example 2 retrieves information about the computer with the FQDN Trust1.litwareinc.com.
Example 3
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 string Trust that have been assigned to trusted application pools. The Filter parameter searches the Identity property of all trusted application computers. The wildcard character (*) 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
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
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 the Get-CsTrustedApplicationComputer cmdlet to retrieve a collection of all the trusted application computers. We then pipe that collection to the Where-Object cmdlet. The Where-Object cmdlet enables 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.
Parameters
-Filter
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
A string that includes wildcards that enables you to retrieve trusted computers based on Identity values that match the given wildcard string.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
Filter
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Identity
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
The fully qualified domain name (FQDN) of the computer you want to retrieve.
Parameter properties
Type: | XdsGlobalRelativeIdentity |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
Identity
Position: | 2 |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Local
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
When present, returns information only for the local computer.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
(All)
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Pool
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
The FQDN of the trusted application pool for which you want to retrieve computer information.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
(All)
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.