Edit a Provider (IIS 7)

  • Article

Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Vista

Change the information for a provider when the connection string that is used to connect to your database has changed or the virtual path of your application has changed.

Note

Editing a configuration setting changes the setting at the local level and for any child levels that inherit the setting.

Prerequisites

For information about the levels at which you can perform this procedure, and the modules, handlers, and permissions that are required to perform this procedure, see Providers Feature Requirements (IIS 7).

Exceptions to feature requirements

  • None

To edit a local provider

You can perform this procedure by using the user interface (UI), by running Appcmd.exe commands in a command-line window, by editing configuration files directly, or by writing WMI scripts.

User Interface

To Use the UI

  1. Open IIS Manager and navigate to the level you want to manage. For information about opening IIS Manager, see Open IIS Manager (IIS 7). For information about navigating to locations in the UI, see Navigation in IIS Manager (IIS 7).

  2. In Features View, double-click Providers.

  3. On the Providers page, in the Feature drop-down list, select one of the following features:

    • .NET Roles - to change the interface between the ASP.NET role management service (the "role manager") and role data sources.

    • .NET Users - to change the interface between the ASP.NET membership service and membership data sources.

    • .NET Profile - to change the interface between the ASP.NET profile service and profile data sources.

  4. In the Actions pane, click Edit.

  5. If the connection string that is used to connect to your database has changed, in the Profile properties section, under Data, type the new name of the connection string that is used to connect to the database in the ConnectionStringName text box.

  6. In the Profile properties section, under Data, type a new name for the provider if you want to change the name of the provider.

  7. If the virtual path of your application has changed, in the Profile properties section, under General, type the new virtual path of the application in the ApplicationName text box.

  8. To change the description of the provider, in the Profile properties section, under General, type a new description in the Description text box.

  9. Click OK.

Command-line

Change connection string

To change the connection string for a provider, use the following syntax:

**appcmd set config /commit:MACHINE /section:**provider /provider. [name='string'].connectionStringName: string

The variable provider is the provider feature, for example, membership for .NET User providers, roleManager for .NET Role providers, or profile for .NET Profile providers. The variable name string is the name of the provider that you want to change. The variable connectionStringName string is the name of the new connection string that is used to connect to the database.

Change provider name

To change the name of a provider, use the following syntax:

**appcmd set config /commit:MACHINE /section:provider/provider. [name='string'].name:**string

The variable provider is the provider feature, for example, membership for .NET User providers, roleManager for .NET Role providers, or profile for .NET Profile providers. The variable name string is the name of the provider that you want to change. The variable **name:**string is the new name for the provider that you want to change.

Change provider description

To change a provider description, use the following syntax:

**appcmd set config /commit:MACHINE /section:**provider /provider. [name='string'].description: string

The variable provider is the provider feature, for example, membership for .NET User providers, roleManager for .NET Role providers, or profile for .NET Profile providers. The variable name string is the name of the provider that you want to change. The variable description string is the new description for the provider.

For more information about Appcmd.exe, see Appcmd.exe (IIS 7).

Configuration

The procedure in this topic affects the following configuration elements:

  • <providers>

For more information about IIS 7 configuration, see IIS 7.0: IIS Settings Schema on MSDN.

WMI

Use the following WMI classes, methods, or properties to perform this procedure:

  • RoleManagerSection.Providers property

  • MembershipSection.Providers property

For more information about WMI and IIS, see Windows Management Instrumentation (WMI) in IIS 7. For more information about the classes, methods, or properties associated with this procedure, see the IIS WMI Provider Reference on the MSDN site.

See Also

Concepts

Configuring Providers in IIS 7