Поделиться через

Средство регистрации SQL Server в ASP.NET (Aspnet_regsql.exe)

  • Статья

Средство регистрации SQL Server в ASP.NET (Aspnet_regsql.exe) предназначено для создания базы данных Microsoft SQL Server, используемой поставщиками SQL Server в ASP.NET. Это средство также позволяет добавлять или удалять элементы существующей базы данных.

Программу Aspnet_regsql.exe можно запускать без аргументов командной строки; в этом случае запускается мастер, помогающий задать сведения о подключении к установленной копии SQL Server, а также установить или удалить элементы базы данных, связанные с функциями членства, управления ролями, профиля, персонализации веб-частей и наблюдения за состоянием системы.

Программу Aspnet_regsql.exe можно также запустить из командной строки, указав элементы базы данных, соответствующие тем или иным функциональным возможностям, которые следует удалить или добавить; для этого используются параметры, перечисленные в следующей таблице.

Примечание

Сведения о поиске соответствующей версии Aspnet_regsql.exe см. в подразделе Поиск подходящей версии Aspnet_regsql.exe далее в этом разделе.

Aspnet_regsql.exe <options>

Параметры подключения SQL

Параметр

Описание

-?

Выводит текст справки по программе Aspnet_regsql.exe в командном окне.

-W

Запускает средство в режиме мастера. Этот режим используется по умолчанию, если не заданы аргументы командной строки.

-C <строка_подключения>

Задает строку подключения к компьютеру с сервером SQL Server, где будет установлена или уже установлена база данных. Этот параметр необязателен, если указываются только сведения о сервере (-S) и учетные данные для входа (-U и -P, или -E).

-S <сервер>

Задает имя компьютера с сервером SQL Server, где будет установлена или уже установлена база данных.

-U <имя_пользователя>

Имя пользователя SQL Server для входа в систему. Данный параметр также требует параметра пароля (-P). Данный параметр не обязателен, если вход выполняется с использованием учетных данных Windows (-E).

-P <пароль>

Пароль SQL Server для входа. При наличии этого параметра требуется также задать имя пользователя (параметр -U). Данный параметр не обязателен, если вход выполняется с использованием учетных данных Windows (-E).

-E

Выполняет проверку подлинности с использованием учетных данных Windows пользователя, входящего в систему.

-sqlexportonly <имя_файла>

Создает файл скрипта SQL, который можно использовать для добавления или удаления указанных функций. Заданные действия не выполняются.

Параметры служб приложений

Параметр

Описание

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

Включает поддержку одной или нескольких служб приложений ASP.NET. Идентификаторы служб можно задавать все сразу или по отдельности. Для служб приложений ASP.NET используются следующие идентификаторы:

all — все службы, включая общие таблицы и хранимые процедуры, совместно используемые службами

m — членство

r — диспетчер ролей

p — профиль

c — персонализация веб-частей

w — веб-события

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

Отключает поддержку одной или нескольких служб приложений. Идентификаторы служб можно задавать все сразу или по отдельности. Для служб приложений ASP.NET используются следующие идентификаторы:

all — все службы, включая общие таблицы и хранимые процедуры, совместно используемые службами

m — членство

r — диспетчер ролей

p — профиль

c — персонализация веб-частей

w — веб-события

-Q

Запускает программу в "тихом" режиме, в котором не запрашивается подтверждение при удалении службы приложений.

-d <база_данных>

Задает имя базы данных, которую следует создать или изменить для использования вместе со службами приложений. Если база данных не указана, используется имя базы данных по умолчанию «aspnetdb».

Примечание

Владельцем элементов базы данных, установленных в базе данных служб приложений, всегда будет учетная запись владельца базы данных SQL Server (dbo).Для установки базы данных служб приложений необязательно иметь полномочия системного администратора компьютера, на котором размещен сервер SQL Server.Чтобы установить базу данных служб приложений, необходимо разрешить вход на сервер SQL Server для ролей db_ddladmin и db_securityadmin в базе данных SQL Server.

Параметры состояния сеанса

Параметр

Описание

-d <база_данных>

Задает имя базы данных для хранения состояния сеанса. Этот параметр необходимо использовать, если параметр -sstype имеет значение c.

-ssadd

Включает поддержку управления состоянием сеанса в режиме SQL Server.

-ssremove

Отключает поддержку управления состоянием сеанса в режиме SQL Server.

-sstype t|p|c

Задает тип используемого состояния сеанса:

t — временный. Данные о состоянии сеанса хранятся в базе данных SQL Server tempdb. Хранимые процедуры для управления состоянием сеанса устанавливаются в базе данных SQL Server ASPState. При перезапуске SQL данные не сохраняются. Это значение по умолчанию.

p — постоянный. Данные о состоянии сеанса и хранимые процедуры хранятся в базе данных SQL Server ASPState.

c — пользовательский. Данные о состоянии сеанса и хранимые процедуры сохраняются в пользовательской базе данных. Имя базы данных должно быть задано с помощью параметра -d.

Заметки

При работе со средством регистрации SQL Server в ASP.NET можно задать параметры нескольких типов. Можно задать подключение SQL, указать службы приложений ASP.NET, которые должны использовать SQL Server для управления информацией, а также включить или отключить поддержку использования SQL Server для хранения процедур и состояния сеанса.

В некоторых службах приложений ASP.NET для управления сохранением и извлечением данных из источников данных используют поставщики. Каждый поставщик привязан к конкретному источнику данных. В ASP.NET имеется поставщик SQL Server для следующих служб ASP.NET:

При установке ASP.NET файл Machine.config для сервера включает элементы конфигурации, которые определяют поставщиков SQL Server для каждой функции ASP.NET, опирающейся на поставщика. Эти поставщики по умолчанию настраиваются для подключения к локальному пользовательскому экземпляру экспресс-выпуска SQL Server. Если изменить строку подключения по умолчанию, используемую поставщиками, то для работы с функциями ASP.NET, настроенными в конфигурации компьютера, необходимо с помощью Aspnet_regsql.exe установить базу данных SQL Server и элементы базы данных, соответствующие выбранным функциям. Если база данных, заданная с помощью Aspnet_regsql.exe, еще не существует (при отсутствии имени базы данных в командной строке по умолчанию используется база данных aspnetdb), то текущий пользователь должен обладать правами на создание баз данных в SQL Server и на создание элементов схемы в базе данных.

Все поставщики SQL Server могут использовать одну и ту же базу данных SQL Server для хранения данных, связанных с каждой конкретной функцией. Каждую функциональную возможность можно использовать отдельно, либо в сочетании с другими функциональными возможностями. Например, службу управления ролями можно использовать саму по себе или в сочетании с информацией о пользователях, контролируемой службой членства.

Дополнительные сведения о поставщиках SQL Server и об ASP.NET см. в разделах Реализация поставщика членства, Реализация поставщика профилей и Реализация поставщика ролей.

Состояние сеанса

Поддержка состояния сеанса ASP.NET позволяет легко сохранять данные о сеансах пользователей в различных источниках для использования в приложениях ASP.NET. По умолчанию информация о состоянии сеанса и соответствующие значения хранятся в памяти внутри процесса ASP.NET. Можно также хранить данные о сеансе в базе данных SQL Server, где они могут использоваться совместно несколькими веб-серверами. Дополнительные сведения о состоянии сеанса см. в разделах Реализация поставщика хранилища состояний сеансов и Режимы состояний сеанса.

Если база данных, указанная в программе Aspnet_regsql.exe для хранения состояния сеанса, еще не существует, то текущий пользователь должен обладать правами на создание баз данных в SQL Server и на создание элементов схемы в базе данных. Если база данных существует, текущий пользователь должен иметь право на создание элементов схемы в существующей базе данных.

Чтобы установить базу данных о состоянии сеансов на сервере SQL Server, запустите программу Aspnet_regsql.exe, задав следующие аргументы:

  • Имя экземпляра SQL Server с помощью параметра -S.

  • Учетные данные входа для учетной записи, которой предоставлено разрешение на создание базы данных на компьютере с сервером SQL Server. Можно с помощью параметра -E воспользоваться данными уже вошедшего пользователя, или с помощью параметра -U указать идентификатор пользователя, а с помощью параметра -P — пароль этого пользователя.

  • Параметр -ssadd для добавления базы данных состояния сеанса.

По умолчанию нельзя использовать средство Aspnet_regsql.exe для установки базы данных состояния сеанса на компьютере, на котором запущен экспресс-выпуск SQL Server. Дополнительные сведения об использовании экспресс-выпуска SQL Server для хранения состояния сеанса см. в разделе Режимы состояний сеанса.

Примеры

Программу Aspnet_regsql.exe можно запускать без аргументов командной строки; в этом случае запускается мастер, помогающий задать сведения о подключении к базе данных SQL Server, а также установить или удалить элементы базы данных, связанные с поддерживаемыми функциями.

Можно также запустить Aspnet_regsql.exe как инструмент командной строки для указания элементов базы данных для отдельных добавляемых или удаляемых функциональных возможностей. Чтобы установить состояние сеанса, необходимо использовать программу командной строки; мастер не установит состояние сеанса.

Для доступа к мастеру запустите Aspnet_regsql.exe без аргументов командной строки, как показано в следующем примере.

aspnet_regsql.exe

Средство регистрации SQL в ASP.NET обычно запускается с параметром -A или -R, определяющим функции, для которых используется поставщик SQL Server. Параметр -A позволяет включить поддержку одной или нескольких функций, а параметр -R отключает поддержку функций. Следующая команда устанавливает элементы базы данных для служб членства и управления ролями на локальном сервере SQL Server с использованием проверки подлинности Windows.

aspnet_regsql.exe -E -S localhost -A mr

Следующая команда создает базу данных с именем ASPState в экземпляре SQL Server с именем "SampleSqlServer » и указывает, что данные сеанса также хранятся в базе данных ASPState.

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

Поиск подходящей версии Aspnet_regsql.exe

Aspnet_regsql.exe устанавливается в каталог Microsoft .NET Framework. Если на компьютере одновременно работает несколько версий .NET Framework, можно установить несколько версий программы. В следующей таблице перечислены расположения, в которых устанавливается эта программа для различных версий .NET Framework.

Версия платформы .NET Framework

Расположение файла Aspnet_regsql.exe

Платформа .NET Framework версии 2.0, версии 3.0 и версии 3.5 (32-разрядные системы)

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

Платформа .NET Framework версии 2.0, версии 3.0 и версии 3.5 (64-разрядные системы)

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

Платформа .NET Framework версии 4 (32-разрядные системы)

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

Платформа .NET Framework версии 4 (64-разрядные системы)

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

См. также

Основные понятия

Реализация поставщика членства

Реализация поставщика профилей

Реализация поставщика ролей