Compartir vía


Configuración de almacenes de persistencia mediante cmdlets de AppFabric

En este tema se describe el modo de usar cmdlets de AppFabric para agregar, obtener, establecer o quitar valores de configuración para un almacén de instancias definido en un archivo de configuración asociado con el ámbito especificado (raíz, sitio web, aplicación, etc.). También se describen cmdlets para crear e inicializar una base de datos de persistencia de SQL Server o quitar artefactos relacionados con la persistencia de un almacén de persistencias de SQL Server.

Nota

Para ejecutar un cmdlet de AppFabric de forma interactiva, use la consola de Windows PowerShell para Microsoft AppFabric 1.1 para Windows Server, escriba el cmdlet correspondiente y presione ENTRAR. Para obtener más información acerca de la ejecución de cmdlets de AppFabric en general, vea Ejecución de cmdlets de AppFabric. Para obtener información detallada sobre los parámetros de ámbito (-SiteName, -VirtualPath, -Uri, etc.), vea Ámbito de Cmdlet y para obtener información detallada sobre los parámetros de canalizaciones (ApplicationInfo y ServiceInfo), vea Canalización de cmdlets.

Procedimiento para agregar, obtener, establecer o quitar definiciones del almacén de instancias mediante cmdlets

Cmdlet

Descripción

Add-ASAppSqlInstanceStore

Agrega una definición del almacén de instancias que señala a la cadena de conexión con nombre especificada o a una cadena de conexión. Un ejemplo del cmdlet:

Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

Set-ASAppSqlInstanceStore

Configura o actualiza una definición del almacén de instancias que señala a la cadena de conexión con nombre especificada o a una cadena de conexión. Un ejemplo del cmdlet:

Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

La cadena de conexión con nombre se define en el archivo de configuración asociado con el nivel especificado o con los niveles superiores en la etiqueta <connectionStrings>.

Remove-ASAppSqlInstanceStore

Quita un registro del almacén de instancias del archivo de configuración asociado con el ámbito especificado. El valor del parámetro Name especifica el nombre del almacén de instancias que debe quitarse. Un ejemplo del cmdlet:

Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore

Puede encontrar definiciones de almacén en un archivo de configuración en el nodo <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores>.

Get-ASAppInstanceStore

Obtiene la información acerca del almacén de instancias asociado con el ámbito especificado. Esta información incluye el nombre del almacén de instancias, el nombre del proveedor del almacén para el almacén, el nombre del sitio, la ruta de acceso virtual y los posibles parámetros del almacén de instancias, tal como la cadena de conexión para un almacén de instancias de flujo de trabajo de SQL. Un ejemplo del cmdlet:

Get-ASAppInstanceStore –root

Opciones de sintaxis para el cmdlet 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>]

En la tabla siguiente se muestran los parámetros específicos del cmdlet Add-ASAppSqlInstanceStore.

Parámetro

Descripción

Name

Nombre de la definición del almacén de instancias en el archivo de configuración asociado con el ámbito especificado (raíz, sitio, aplicación, etc.).

ConnectionString

Cadena de conexión que se usa para conectar con el almacén.

ConnectionStringName

Nombre de la definición de la cadena de conexión definida en un archivo de configuración.

Opciones de sintaxis para el cmdlet 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>]

En la tabla siguiente se muestran los parámetros específicos del cmdlet Set-ASAppSqlInstanceStore.

Parámetro

Descripción

Name

Nombre de la definición del almacén de instancias en el archivo de configuración asociado con el ámbito especificado (raíz, sitio, aplicación, etc.).

ConnectionString

Cadena de conexión que se usa para conectar con el almacén.

ConnectionStringName

Nombre de la definición de la cadena de conexión definida en un archivo de configuración.

Opciones de sintaxis para el cmdlet 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>]

En la tabla siguiente se muestran los parámetros específicos del cmdlet Remove-ASAppSqlInstanceStore.

Parámetro

Descripción

Name

Nombre de la definición del almacén de instancias en el archivo de configuración asociado con el ámbito especificado (raíz, sitio, aplicación, etc.).

Opciones de sintaxis para el cmdlet 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>]

En la tabla siguiente se muestran los parámetros específicos del cmdlet Get-ASAppInstanceStore.

Parámetro

Descripción

Name

Nombre de la definición del almacén de instancias en el archivo de configuración asociado con el ámbito especificado (raíz, sitio, aplicación, etc.).

Procedimiento para inicializar o quitar bases de datos de persistencia de SQL Server mediante cmdlets

Cmdlet

Descripción

Initialize-ASPersistenceSqlDatabase

Crea e inicializa una base de datos de persistencia de SQL Server en el servidor de la base de datos especificada si ésta no existe aún en el servidor. El proceso de inicialización crea artefactos relacionados con persistencia (tablas, vistas, procedimientos almacenados, etc.). Si la base de datos ya existe en el servidor, el cmdlet inicializa la base de datos con los artefactos de persistencia. El cmdlet también agrega los grupos de Windows especificados a roles correspondientes de SQL Server. Un ejemplo del cmdlet:

Initialize-ASPersistenceSqlDatabase  -Database TempPersistenceDB -Server "(local)"

Remove-ASPersistenceSqlDatabase

Quita todos los artefactos de persistencia (procedimientos almacenados, tablas, vistas, etc.) de la base de datos especificada, pero no quita la base de datos en sí. Un ejemplo del cmdlet:

Remove-ASPersistenceSqlDatabase  -Database TempPersistenceDB -Server "(local)"

Opciones de sintaxis para el cmdlet 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>]

En la tabla siguiente se muestran los parámetros específicos del cmdlet Initialize-ASPersistenceSqlDatabase.

Parámetro

Descripción

Servidor

Nombre del servidor en el cual reside la base de datos.

Base de datos

Nombre de la base de datos de persistencia de SQL Server.

ConnectionString

Cadena de conexión que se usa para conectar con una base de datos de persistencia de SQL Server.

Puede especificar un servidor y una base de datos o especificar una cadena de conexión que se usará para conectar a una base de datos de persistencia de SQL Server.

Admins

Agrega el grupo de Windows especificado a los roles InstanceStoreObservers, WorkflowActivationUsers, WorkflowAdministrators y WorkflowManagementServiceUsers en la base de datos de persistencia de SQL Server especificada.

Lectores

Agrega el grupo de Windows especificado al rol InstanceStoreObservers en la base de datos de persistencia de SQL Server especificada.

Usuarios

Agrega el grupo de Windows especificado al rol InstanceStoreUsers en la base de datos de persistencia de SQL Server especificada.

Opciones de sintaxis para el cmdlet Remove-ASPersistenceSqlDatabase

Remove-ASPersistenceSqlDatabase -Database <String> [-Force] [-Server <String>] [<CommonParameters>]

Remove-ASPersistenceSqlDatabase -ConnectionString <String> [-Force] [<CommonParameters>]

En la tabla siguiente se muestran los parámetros específicos del cmdlet Remove-ASPersistenceSqlDatabase.

Parámetro

Descripción

Servidor

Nombre del servidor en el cual reside la base de datos.

Base de datos

Nombre de la base de datos de persistencia de SQL Server.

ConnectionString

Cadena de conexión que se usa para conectar con una base de datos de persistencia de SQL Server.

Puede especificar un servidor y una base de datos o especificar una cadena de conexión que se usará para conectar a una base de datos de persistencia de SQL Server.

  2012-03-05