Remove the Trusted Application Definition

 

Topic Last Modified: 2011-04-11

Typically, you manage trusted applications by using the Lync Server Management Shell to run Windows PowerShell command-line interface cmdlets. You also use cmdlets to prepare a pool for removal. Before you can remove the pool, you must remove the application registration from the pool.

Important

This procedure does not remove the application. To remove the application, refer to the documentation for the application.

To remove the trusted application definition

  1. Log on to the computer where Topology Builder is installed as a member of the Domain Admins group and the RTCUniversalServerAdmins group.

    Important

    For this procedure, this should be a Front End Server or pool.

  2. Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2010, and then click Lync Server Management Shell.

  3. In the Lync Server Management Shell, type one of the following:

    • Get-CsTrustedApplication

      Lists Identity, Computer, Service, Protocol and application ID information for all trusted applications registered.

    • Get-CsTrustedApplication -Identity <ExternalApplicationIdentity>

      Lists properties for the Trusted Application Server. For example, Get-CsTrustedApplication -Identity appsrv.contoso.net/tapp1 returns properties for appsrv.contoso.net and application tapp1.

    • Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "<TrustedApplicationPoolFqdn>"}

      Lists only trusted applications and properties registered on the Trusted Application Server. For example, Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "apppool.contoso.net"} returns the trusted applications and properties for the Trusted Application Server pool apppool.contoso.net.

    The –Identity parameter string that you use with the Remove-CsTrustedApplication cmdlet is the application identifier as displayed in the output from Get-CsTrustedApplication. Use the fully qualified domain name (FQDN) of the Trusted Application Server, a slash (/), and then the application ID.

    Tip

    Use the first two cmdlet strings in situations where you know what Trusted Application Server you need to remove, but you are not sure what applications in the topology might be affected by the removal of the Trusted Application Server. The first cmdlet string shows you a list of the applications. The second cmdlet lists detailed information about the Trusted Application Server and the application. The third cmdlet returns details on all applications deployed on the Trusted Application Server.

  4. In the Lync Server Management Shell, type Remove-CsTrustedApplication -Identity <ExternalApplicationIdentity>.

    Note

    The cmdlet does not return a confirmation of success. Run Get-CsTrustedApplication again to confirm that the application registration is no longer registered.

  5. In the Lync Server Management Shell, type Get-CsTrustedApplication, and then review the output to confirm that the application is no longer registered.

  6. Start Topology Builder: Click Start, click All Programs, click Microsoft Lync Server 2010, and then click Lync Server Topology Builder.

  7. When Topology Builder prompts you to select the source of the Lync Server 2010 topology documents, select Download Topology from existing deployment, and then click OK.

  8. In Save Topology As, type a name for the topology document in File name, and then click Save.

  9. In Topology Builder, expand Trusted Application Servers, right-click the Trusted Application Server or pool, click Delete, and then click OK.

    Warning

    If you accidentally delete the wrong object and you have not published the topology yet, right-click the Lync Server 2010 node, click Download Topology, and then click Yes in Confirm Download Topology.

  10. Publish the topology, check replication status, and then run the Lync Server Deployment Wizard as needed.