Get-CsTrustedApplicationEndpoint
Retrieves information about one or more trusted application endpoints. This cmdlet was introduced in Lync Server 2010.
Syntax
Get-CsTrustedApplicationEndpoint
[[-Identity] <UserIdParameter>]
[-Filter <String>]
[-ApplicationId <String>]
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-OU <OUIdParameter>]
[-ResultSize <Microsoft.Rtc.Management.ADConnect.Core.Unlimited`1[System.UInt32]>]
[-TrustedApplicationPoolFqdn <String>]
[<CommonParameters>]
Description
A trusted application endpoint is an Active Directory contact object that enables routing of calls to a trusted application. This cmdlet retrieves one or more existing endpoint contact objects in Active Directory Domain Services.
Examples
-------------------------- Example 1 --------------------------
Get-CsTrustedApplicationEndpoint
This example retrieves information about all trusted application endpoints defined within the Skype for Business Server deployment.
-------------------------- Example 2 --------------------------
Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"
Example 2 retrieves information about the application endpoint contact with the SIP address endpoint1@litwareinc.com. Note that the sip: prefix is required when using a SIP address as the Identity.
-------------------------- Example 3 --------------------------
Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
Example 3 retrieves all trusted application endpoints that have the string "endpoint" anywhere within their display name. To do this, the command uses the Filter parameter. The value of the parameter filters to find endpoint objects that have a display name (DisplayName) that contains (-like) the string endpoint (endpoint - the wildcard characters indicate that any characters can come before or after the string endpoint, meaning endpoint can be anywhere within the display name).
-------------------------- Example 4 --------------------------
Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn
Example 4 will return all trusted application endpoints associated with the application tapp2. This is accomplished by passing the ID tapp2 to the ApplicationId parameter. Notice that we didn't supply a pool FQDN; this means that if an application with the ID tapp2 exists on more than one pool, endpoints for all those applications will be retrieved. The next part of this command pipes the returned object or objects to the Select-Object cmdlet, which displays only the SipAddress, DisplayName, and OwnerUrn properties of those objects.
Parameters
-ApplicationId
The application ID of the trusted application for the endpoint you want to retrieve.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Credential
Alternate credentials to be used to retrieve the endpoint. You can retrieve a PSCredential object by calling the Get-Credential cmdlet.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-DomainController
Allows you to specify a domain controller. If no domain controller is specified, the first available will be used.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Filter
Enables you to limit the returned data by filtering on specific attributes for Skype for Business Server. For example, you can limit returned data to contacts whose display names or SIP addresses match a certain wildcard pattern.
The Filter parameter uses the same Windows PowerShell filtering syntax that is used by the Where-Object cmdlet. For example, a filter that returns only contacts that have been enabled for Enterprise Voice would look like this: {EnterpriseVoiceEnabled -eq $True}, with EnterpriseVoiceEnabled representing the Active Directory attribute, -eq representing the comparison operator (equal to), and $True (a built-in Windows PowerShell variable) representing the filter value.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
The Identity (distinguished name), SIP address, or display name of the application endpoint to be retrieved.
Type: | UserIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-OU
The OU in which the endpoint resides.
Type: | OUIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-ResultSize
The maximum number of endpoint records to retrieve.
Type: | Microsoft.Rtc.Management.ADConnect.Core.Unlimited`1[System.UInt32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-TrustedApplicationPoolFqdn
The fully qualified domain name (FQDN) of the trusted application pool associated with the application for the endpoint you want to retrieve.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
String
Accepts a pipelined string value representing the Identity of a user account.
Outputs
Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact