Herramienta Registro de SQL Server para ASP.NET (Aspnet_regsql.exe)

La herramienta Registro de SQL para ASP.NET (Aspnet_regsql.exe) se utiliza para crear una base de datos de Microsoft SQL Server para los proveedores de SQL Server de ASP.NET. La herramienta también se utiliza para agregar o quitar opciones de una base de datos existente.

Si se ejecuta sin argumentos de línea de comandos, Aspnet_regsql.exe ejecuta un asistente que le guiará en el proceso de especificar la información de conexión para la instalación de SQL Server y en el proceso de instalar o quitar los elementos de base de datos de las características de pertenencia, administración de funciones, perfiles, personalización de elementos Web y supervisión de estado.

Aspnet_regsql.exe se puede ejecutar como herramienta de línea de comandos para especificar los elementos de base de datos de determinadas características que se van a agregar o quitar, mediante las opciones que figuran en la siguiente tabla.

NotaNota

Para obtener información sobre cómo encontrar la versión correcta de Aspnet_regsql.exe, vea Encontrar la versión correcta de Aspnet_regsql.exe más adelante en este tema.

Aspnet_regsql.exe <options>

Opción

Descripción

-?

Imprime el texto de la Ayuda de Aspnet_regsql.exe en la ventana de comandos.

-W

Ejecuta la herramienta en modo de asistente. Éste es el valor predeterminado si no se especifica ningún argumento de la línea de comandos.

-C <cadena de conexión>

Especifica la cadena de conexión con el equipo que ejecuta SQL Server y en el que se va a instalar o ya está instalada la base de datos. Esta opción no es necesaria si sólo especifica el servidor (-S) y la información de inicio de sesión (-U y -P o -E).

-S <servidor>

Especifica el nombre del equipo que ejecuta SQL Server y en el que se va a instalar o ya está instalada la base de datos.

-U <Id. de acceso>

Identificador de usuario de SQL Server con el que se va a iniciar sesión. Esta opción también requiere la opción de contraseña (-P). Esta opción no es necesaria si utiliza las credenciales de Windows para la autenticación (-E).

-P <contraseña>

Contraseña de SQL Server para iniciar sesión. Esta opción también requiere la opción de identificador de usuario (-U). Esta opción no es necesaria si utiliza las credenciales de Windows para la autenticación (-E).

-E

Para la autenticación se utilizan las credenciales de Windows del usuario que ha iniciado la sesión actual.

-sqlexportonly <nombre de archivo>

Genera un archivo de script SQL que se puede utilizar para agregar o quitar las características especificadas. No se realizan las acciones especificadas.

Opción

Descripción

-A all|m|r|p|c|w

Agrega compatibilidad para uno o varios servicios de aplicaciones ASP.NET. Los identificadores de servicio se pueden especificar juntos o separados. Se utilizan los siguientes identificadores para los servicios de aplicaciones ASP.NET:

all : todos los servicios, incluyendo las tablas comunes y los procedimientos almacenados compartidos por los servicios.

m : pertenencia

r : administrador de funciones

p : perfil

c : personalización de elementos Web

w : eventos Web

-R all|m|r|p|c|w

Quita compatibilidad con uno o varios servicios de aplicaciones. Los identificadores de servicio se pueden especificar juntos o separados. Se utilizan los siguientes identificadores para los servicios de aplicaciones ASP.NET:

all : todos los servicios, incluyendo las tablas comunes y los procedimientos almacenados compartidos por los servicios.

m : pertenencia

r : administrador de funciones

p : perfil

c : personalización de elementos Web

w : eventos Web

-Q

Ejecuta la herramienta en modo no interactivo y no solicita la confirmación antes de quitar un servicio de aplicación.

-d <base de datos>

Especifica el nombre de la base de datos que se va a crear o modificar para su uso con los servicios de aplicaciones. Si no se especifica la base de datos, se utilizará el nombre de base de datos predeterminado, "aspnetdb".

NotaNota

La cuenta (dbo) de propietario de base de datos de SQL Server siempre será propietaria de los elementos de base de datos que se instalan en la base de datos de servicios de aplicación. No necesita ser administrador del sistema en el equipo que ejecuta SQL Server para instalar la base de datos de servicios de aplicación. Para instalar la base de datos de servicios de aplicación, debe concederse un inicio de sesión de SQL Server a los roles db_ddladmin y db_securityadmin para la base de datos de SQL Server.

Opción

Descripción

-d <base de datos>

Especifica el nombre de la base de datos en la que se va a almacenar el estado de sesión. Esta opción debe utilizarse si el valor de -sstype se establece en c.

-ssadd

Agrega compatibilidad para el modo de estado de sesión de SQL Server.

-ssremove

Quita la compatibilidad para el modo de estado de sesión de SQL Server.

-sstype t|p|c

Especifica el tipo de estado de sesión que se va a utilizar:

t : temporal. Los datos del estado de sesión se almacenan en la base de datos tempdb de SQL Server. Los procedimientos almacenados para administrar el estado de sesión se instalan en la base de datos ASPState de SQL Server. No se conservan los datos si se reinicia SQL. Éste es el valor predeterminado.

p : guardado. Los datos del estado de sesión y los procedimientos almacenados se almacenan en la base de datos ASPState de SQL Server.

c : personalizado. Los datos del estado de sesión y los procedimientos almacenados se almacenan en una base de datos personalizada. El nombre de la base de datos debe especificarse mediante la opción -d.

Se pueden establecer varios tipos de opciones con la herramienta Registro de SQL Server para ASP.NET. Se puede especificar una conexión SQL, especificar qué servicios de aplicaciones ASP.NET utilizan SQL Server para administrar la información, y agregar o quitar compatibilidad con el uso de SQL Server para almacenar procedimientos y estados de sesión.

Varios servicios de aplicaciones ASP.NET dependen de un proveedor para administrar el almacenamiento y la recuperación de datos desde un origen de datos. Cada proveedor es específico del origen de datos. ASP.NET incluye un proveedor de SQL Server para las siguientes características de ASP.NET:

Al instalar ASP.NET, el archivo Machine.config del servidor incluye elementos de configuración que especifican los proveedores de SQL Server para cada una de las características de ASP.NET que dependen de un proveedor. Estos proveedores se configuran, de manera predeterminada, para conectarse a una instancia de usuario local de SQL Server Express. Si cambia la cadena de conexión predeterminada utilizada por los proveedores, antes de poder utilizar cualquiera de las características de ASP.NET configurada en la configuración del equipo, debe instalar la base de datos de SQL Server y los elementos de base de datos para su característica escogida utilizando Aspnet_regsql.exe. Si la base de datos que especifica con Aspnet_regsql.exe no existe ya (aspnetdb será la base de datos predeterminada si no se ha especificado ninguna en la línea de comandos), el usuario actual deberá tener derechos para crear bases de datos en SQL Server y crear elementos de esquema en una base de datos.

Cada proveedor de SQL Server puede utilizar la misma base de datos de SQL Server para almacenar los datos correspondientes a esa característica particular. Se puede utilizar cada característica individualmente o junto con otras características. Por ejemplo, la administración de funciones puede utilizarse sola o junto con la información de usuario administrada por la característica de pertenencia.

Para obtener más información sobre los proveedores de SQL Server y ASP.NET, vea Implementar un proveedor de pertenencias, Implementar un proveedor de perfiles e Implementar un proveedor de roles.

Estado de sesión

El estado de sesión de ASP.NET se ha diseñado para que pueda almacenar con facilidad los datos de sesión del usuario en diferentes orígenes de las aplicaciones ASP.NET. De forma predeterminada, los valores y la información del estado de sesión se almacenan en memoria en el proceso de ASP.NET. Otra alternativa es almacenar los datos de sesión en una base de datos de SQL Server, donde varios servidores Web pueden compartir esta información. Para obtener más información acerca de los estados de sesión, vea Implementar un proveedor de almacén de estados de sesión y Modos de estado de sesión.

Si la base de datos que especifique para el estado de sesión con Aspnet_regsql.exe no existe, el usuario actual deberá tener derechos para crear bases de datos en SQL Server y crear elementos de esquema en una base de datos. Si la base de datos existe, el usuario actual deberá tener derechos para crear elementos de esquema en la base de datos existente.

Para instalar la base de datos de estados de sesión en SQL Server, ejecute la herramienta Aspnet_regsql.exe y proporcione la información siguiente con el comando:

  • El nombre de la instancia de SQL Server, mediante la opción -S.

  • Las credenciales de inicio de sesión para una cuenta con permiso para crear una base de datos en un equipo que ejecute SQL Server. Seleccione la opción -E para utilizar el usuario que tiene la sesión actual abierta o utilice la opción -U para especificar un identificador de usuario junto con la opción -P para especificar una contraseña.

  • La opción de la línea de comandos -ssadd para agregar la base de datos de estado de sesión.

De forma predeterminada, no se puede utilizar Aspnet_regsql.exe para instalar la base de datos de estados de sesión en un equipo que ejecute SQL Server Express. Para obtener más información sobre cómo utilizar SQL Server Express para almacenar el estado de sesión, vea Modos de estado de sesión.

Si se ejecuta sin argumentos de línea de comandos, Aspnet_regsql.exe ejecuta un asistente que le guiará en el proceso de especificar la información de conexión de la base de datos de SQL Server, así como en el proceso de instalar o quitar elementos de base de datos de las características compatibles.

Aspnet_regsql.exe se puede ejecutar como herramienta de línea de comandos para especificar los elementos de base de datos de determinadas características que se van a agregar o quitar. Para definir el estado de sesión, debe utilizar la herramienta de la línea de comandos; el asistente no definirá el estado de sesión.

Para ejecutar el asistente, ejecute Aspnet_regsql.exe sin argumentos de línea de comandos, tal como se muestra en el ejemplo siguiente:

aspnet_regsql.exe

La herramienta Registro de SQL Server para ASP.NET suele utilizarse con la opción -A o -R para especificar las características que utilizan un proveedor de SQL Server. La opción -A permite agregar compatibilidad con una o varias características, mientras que la opción -R permite quitar una característica. El siguiente comando instala los elementos de base de datos para las características de pertenencia y administración de funciones en el equipo local donde se ejecuta SQL Server mediante la autenticación de Windows.

aspnet_regsql.exe -E -S localhost -A mr

El siguiente comando crea una base de datos denominada ASPState en una instancia de SQL Server denominada "SampleSqlServer" y especifica que los datos de sesión también se almacenan en la base de datos ASPState.

aspnet_regsql.exe -S SampleSqlServer -E -ssadd -sstype p

Aspnet_regsqls.exe se instala en el directorio de Microsoft .NET Framework. Si en el equipo se ejecutan varias versiones de .NET Framework en paralelo, es posible que haya varias versiones de la herramienta instaladas. En la tabla siguiente se muestran las ubicaciones en las que se instala la herramienta en las diferentes versiones de .NET Framework.

Versión de .NET Framework

Ubicación del archivo Aspnet_regsql.exe

.NET Framework versión 2.0, versión 3.0 y versión 3.5 (sistemas de 32 bits)

%windir%\Microsoft.NET\Framework\v2.0.50727

.NET Framework versión 2.0, versión 3.0 y versión 3.5 (sistemas de 64 bits)

%windir%\Microsoft.NET\Framework64\v2.0.50727

.NET Framework versión 4 (sistemas de 32 bits)

%windir%\Microsoft.NET\Framework\v4.0.30319

.NET Framework versión 4 (sistemas de 64 bits)

%windir%\Microsoft.NET\Framework64\v4.0.30319

Adiciones de comunidad

Mostrar: