Add or remove a service application connection to a Web application (SharePoint Server 2010)

 

Applies to: SharePoint Server 2010, SharePoint Foundation 2010

When you create a service application in Microsoft SharePoint Server 2010, a service application connection is created. A service application connection is also referred to as an application proxy. A service application connection associates the service application to Web applications via membership in a service application connection group (also referred to as application proxy group).

This article describes how to add or remove service application connections to a service application connection group.

Important

If you are creating a service application connection to a service application in a remote farm, you should read the article Share service applications across farms (SharePoint Server 2010) to gain a full understanding of the requirements to successfully share service applications across farms.

By default, a new service application connection is added to the farm’s Default group of service application connections when you create the service application by using Central Administration. You can override this default membership. If a new service application is created by using Windows PowerShell 2.0 instead of by using Central Administration, the new service application does not automatically become a member of the Default service application connections group unless the -default parameter is supplied.

Note

For more information about how to create and configure service applications, see Manage service applications (SharePoint Server 2010).

By default, all Web applications are associated with the farm’s Default group of service application connections, although you can change this setting. You can also create one custom connection group for each Web application in the farm. You can change the service applications with which a Web application is associated at any time, and you can change the service applications that are included in the Default service application connection group.

For more information about how to create and configure Web applications, see Web applications management (SharePoint Server 2010).

Editing a service connection group

You can add or remove service application connections to a service application connection group by using Central Administration or by using Windows PowerShell 2.0 cmdlets.

To edit a service connection group by using Central Administration

  1. Verify that the user account that is performing this procedure is a member of the Farm Administrators SharePoint group.

  2. On the Central Administration Home page, click Application Management.

  3. On the Application Management page, in the Service Applications section, click Configure service application associations.

  4. On the Service Application Associations page, select Web Applications from the View drop-down menu.

  5. In the list of Web applications, in the Application Proxy Group column, click the name of the service application connection group that you want to change.

  6. To add a service connection to the group, select the check box that is next to the service application that you want to add to the connection group. To remove a service application connection from the connection group, clear the check box next to the service application that you want to remove from the connection group. When you have made the changes that you want, click OK.

    Note

    You can also change custom service application connection groups by clicking Manage Web Applications from the Central Administration Home page, selecting a listed Web application, and then clicking Service Connections on the ribbon. You cannot change the default service applications connection group through this page, however.

To add a service application connection to a service application connection group by using Windows PowerShell

  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin.

  2. On the Start menu, click Administrative Tools.

  3. Click SharePoint 2010 Management Shell.

  4. At the Windows PowerShell command prompt (that is, PS C:\>), type the following command, and then press ENTER:

    Add-SPServiceApplicationProxyGroupMember [-Identity <the service application proxy group>] [-Member <members to add to the service application proxy group>]

For more information, see Add-SPServiceApplicationProxyGroupMember.

To remove a service application connection from a service application connection group by using Windows PowerShell

  1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin.

  2. On the Start menu, click Administrative Tools.

  3. Click SharePoint 2010 Management Shell.

  4. At the Windows PowerShell command prompt (that is, PS C:\>), type the following command, and then press ENTER:

    Remove-SPServiceApplicationProxyGroupMember [-Identity <SPServiceApplicationProxyGroupPipeBind>] [-Member <SPServiceApplicationProxyPipeBind[]>]

For more information, see Remove-SPServiceApplicationProxyGroupMember.