Настройка хранилищ сохраняемости с помощью командлетов Windows Server AppFabric
В этом разделе рассматривается использование командлетов AppFabric для добавления, получения, установки и удаления значений конфигурации для хранилища экземпляров, заданного в файле конфигурации, связанном с указанной областью (корень, веб-сайт, приложение и т.п.). Здесь также описываются командлеты для создания и инициализации базы данных сохраняемости SQL Server или для удаления артефактов, связанных с сохраняемостью, из хранилища сохраняемости SQL Server.
Примечание
Чтобы выполнить командлет AppFabric интерактивно, необходимо использовать консоль Windows PowerShell для Windows Server AppFabric, ввести в ней соответствующий командлет и нажать клавишу ВВОД. Дополнительные сведения о выполнении командлетов AppFabric см. в разделе Запуск командлетов Windows Server AppFabric. Дополнительные сведения о параметрах области (-SiteName, -VirtualPath, -Uri и т. п.) см. в разделе Область действия командлета, а дополнительные сведения о параметрах конвейеризации (ApplicationInfo и ServiceInfo) см. в разделе Конвейеризация командлетов.
Добавление, получение, установка и удаление определений хранилищ экземпляров с помощью командлетов
Командлет |
Описание |
Add-ASAppSqlInstanceStore |
Добавляет определение хранилища экземпляра, указывающее заданную именованную строку подключения или строку подключения. Пример командлета: |
Set-ASAppSqlInstanceStore |
Устанавливает или обновляет определение хранилища экземпляра, указывающее заданную именованную строку подключения или строку подключения. Пример командлета: Именованная строка подключения определяется в файле конфигурации, связанном с указанным уровнем или с более высокими уровнями, в теге <connectionStrings>. |
Remove-ASAppSqlInstanceStore |
Удаляет регистрацию хранилища экземпляров в файле конфигурации, связанном с заданной областью. Значение параметра Name указывает имя удаляемого хранилища экземпляров. Пример командлета: Определения хранилищ можно найти в файле конфигурации в узле <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores>. |
Get-ASAppInstanceStore |
Получает сведения о хранилище экземпляров, связанном с заданной областью. В эти сведения входит имя хранилища экземпляров, имя поставщика для этого хранилища, имя сайта, виртуальный путь и другие параметры хранилища экземпляров, например строка подключения для хранилища экземпляров рабочих процессов SQL. Пример командлета: |
Варианты синтаксиса для командлета Add-ASAppSqlInstanceStore
Add-ASAppSqlInstanceStore [-Root] -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]
Add-ASAppSqlInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]
Add-ASAppSqlInstanceStore [-Uri] <Uri> -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]
Add-ASAppSqlInstanceStore -ApplicationObject <ApplicationInfo> -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]
В следующей таблице приведены параметры, относящиеся к командлету Add-ASAppSqlInstanceStore.
Параметр |
Описание |
Name |
Имя определения хранилища экземпляров в файле конфигурации, связанном с заданной областью (корень, сайт, приложение и т.п.). |
ConnectionString |
Строка подключения, используемая для подключения к хранилищу. |
ConnectionStringName |
Имя определения строки подключения, заданного в файле конфигурации. |
Варианты синтаксиса для командлета Set-ASAppSqlInstanceStore
Set-ASAppSqlInstanceStore [-Root] -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]
Set-ASAppSqlInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]
Set-ASAppSqlInstanceStore [-Uri] <Uri> -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]
Set-ASAppSqlInstanceStore -ApplicationObject <ApplicationInfo> -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]
В следующей таблице приведены параметры, относящиеся к командлету Set-ASAppSqlInstanceStore.
Параметр |
Описание |
Name |
Имя определения хранилища экземпляров в файле конфигурации, связанном с заданной областью (корень, сайт, приложение и т.п.). |
ConnectionString |
Строка подключения, используемая для подключения к хранилищу. |
ConnectionStringName |
Имя определения строки подключения, заданного в файле конфигурации. |
Варианты синтаксиса для командлета Remove-ASAppSqlInstanceStore
Remove-ASAppSqlInstanceStore [-Root] -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-ASAppSqlInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-ASAppSqlInstanceStore [-Uri] <Uri> -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-ASAppSqlInstanceStore -ApplicationObject <ApplicationInfo> -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]
В следующей таблице приведены параметры, относящиеся к командлету Remove-ASAppSqlInstanceStore.
Параметр |
Описание |
Name |
Имя определения хранилища экземпляров в файле конфигурации, связанном с заданной областью (корень, сайт, приложение и т.п.). |
Варианты синтаксиса для командлета Get-ASAppInstanceStore
Get-ASAppInstanceStore [-Root] [-Name <String>] [<CommonParameters>]
Get-ASAppInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] [-Name <String>] [<CommonParameters>]
Get-ASAppInstanceStore [-Uri] <Uri> [-Name <String>] [<CommonParameters>]
Get-ASAppInstanceStore -ApplicationObject <ApplicationInfo> [-Name <String>] [<CommonParameters>]
В следующей таблице приведены параметры, относящиеся к командлету Get-ASAppInstanceStore.
Параметр |
Описание |
Name |
Имя определения хранилища экземпляров в файле конфигурации, связанном с заданной областью (корень, сайт, приложение и т.п.). |
Инициализация или удаление баз данных сохраняемости SQL Server с помощью командлетов
Командлет |
Описание |
Initialize-ASPersistenceSqlDatabase |
Создает и инициализирует базу данных сохраняемости SQL Server на указанном сервере баз данных, если эта база данных еще не существует на этом сервере. Процесс инициализации создает артефакты, относящиеся к сохраняемости (таблицы, представления, хранимые процедуры и т.п.). Если эта база данных уже существует на этом сервере, то командлет инициализирует ее с артефактами сохраняемости. Командлет также добавляет указанные группы Windows в соответствующие роли SQL Server. Пример командлета: |
Remove-ASPersistenceSqlDatabase |
Удаляет все артефакты сохраняемости (хранимые процедуры, таблицы, представления и т.п.) из указанной базы данных, но не удаляет саму базу данных. Пример командлета: |
Варианты синтаксиса для командлета Initialize-ASPersistenceSqlDatabase
Initialize-ASPersistenceSqlDatabase -Database <String> [-Admins <String>] [-Confirm] [-Force] [-Readers <String>] [-Server <String>] [-Users <String>] [-WhatIf] [<CommonParameters>]
Initialize-ASPersistenceSqlDatabase -ConnectionString <String> [-Admins <String>] [-Confirm] [-Force] [-Readers <String>] [-Users <String>] [-WhatIf] [<CommonParameters>]
В следующей таблице приведены параметры, относящиеся к командлету Initialize-ASPersistenceSqlDatabase.
Параметр |
Описание |
Server |
Имя сервера, на котором размещается база данных. |
Database |
Имя базы данных сохраняемости SQL Server. |
ConnectionString |
Строка подключения, используемая для подключения к базе данных сохраняемости SQL Server. Можно задать сервер и базу данных либо указать строку подключения, которая используется для подключения к базе данных сохраняемости SQL Server. |
Admins |
Добавляет указанную группу Windows в роли InstanceStoreObservers, WorkflowActivationUsers, WorkflowAdministrators и WorkflowManagementServiceUsers в указанной базе данных сохраняемости SQL Server. |
Readers |
Добавляет указанную группу Windows в роль InstanceStoreObservers в указанной базе данных сохраняемости SQL Server. |
Users |
Добавляет указанную группу Windows в роль InstanceStoreUsers в указанной базе данных сохраняемости SQL Server. |
Варианты синтаксиса для командлета Remove-ASPersistenceSqlDatabase
Remove-ASPersistenceSqlDatabase -Database <String> [-Force] [-Server <String>] [<CommonParameters>]
Remove-ASPersistenceSqlDatabase -ConnectionString <String> [-Force] [<CommonParameters>]
В следующей таблице приведены параметры, относящиеся к командлету Remove-ASPersistenceSqlDatabase.
Параметр |
Описание |
Server |
Имя сервера, на котором размещается база данных. |
Database |
Имя базы данных сохраняемости SQL Server. |
ConnectionString |
Строка подключения, используемая для подключения к базе данных сохраняемости SQL Server. Можно задать сервер и базу данных либо указать строку подключения, которая используется для подключения к базе данных сохраняемости SQL Server. |
2011-12-05