Edit a Provider (IIS 7)
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
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).
In Features View, double-click Providers.
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.
In the Actions pane, click Edit.
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.
In the Profile properties section, under Data, type a new name for the provider if you want to change the name of the provider.
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.
To change the description of the provider, in the Profile properties section, under General, type a new description in the Description text box.
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.