Configurar os repositórios de persistência usando cmdlets do Windows Server AppFabric

Artigo
12/05/2011

Este tópico descreve como usar cmdlets do AppFabric para adicionar, obter, definir ou remover valores de configuração de um repositório de instâncias definido em um arquivo de configuração associado ao escopo especificado (raiz, site, aplicativo, etc). Ele também descreve cmdlets para criar e inicializar um banco de dados de persistência SQL Server ou para remover artefatos relacionados à persistência de um repositório de persistência do SQL Server.

Dica

Para executar interativamente um cmdlet do AppFabric, é necessário usar o console do Windows PowerShell para Windows Server AppFabric, inserir o cmdlet adequado e pressionar ENTER. Para obter mais informações sobre como executar cmdlets do AppFabric, em geral, consulte Executando cmdlets do Windows Server AppFabric. Para obter informações detalhadas sobre parâmetros de escopo (-SiteName, -VirtualPath, -Uri, etc.), consulte Escopo do cmdlet e para obter informações detalhadas sobre parâmetros de pipe (ApplicationInfo e ServiceInfo), consulte Pipe de cmdlet.

Para adicionar, obter, definir ou remover definições do repositório de instâncias usando cmdlets

Cmdlet	Descrição
Add-ASAppSqlInstanceStore	Adicione uma definição do repositório de instâncias que aponte para a cadeia de conexão nomeada especificada ou para outra cadeia de conexão. Um exemplo de cmdlet: `Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString`
Set-ASAppSqlInstanceStore	Configure ou atualize uma definição do repositório de instâncias para apontar para a cadeia de conexão nomeada especificada ou para outra cadeia de conexão. Um exemplo de cmdlet: `Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString` A cadeia de conexão nomeada é definida no arquivo de configuração associado ao nível especificado ou aos níveis mais altos na marcação <connectionStrings>.
Remove-ASAppSqlInstanceStore	Remove um registro do repositório de instâncias no arquivo de configuração associado ao escopo especificado. O valor do parâmetro Name especifica o nome do repositório de instâncias que será removido. Um exemplo de cmdlet: `Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore` Você pode encontrar definições de repositórios em um arquivo de configuração no nó <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores>.
Get-ASAppInstanceStore	Obtém as informações sobre o repositório de instâncias que está associado ao escopo especificado. Essas informações incluem o nome do repositório de intâncias, o nome do provedor de repositórios para armazenameto, o nome do site, o caminho virtual e todos os parâmetros do repositório de instâncias, como a cadeia de conexão de um Repositório de Instâncias do Fluxo de Trabalho SQL. Um exemplo de cmdlet: `Get-ASAppInstanceStore –root`

Opções de sintaxe para o 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>]

A tabela a seguir lista os parâmetros que são específicos ao cmdlet Add-ASAppSqlInstanceStore.

Parâmetro	Descrição
Nome	Nome de definição do repositório de instâncias no arquivo de configuração associado ao escopo especificado (raiz, site, aplicativo, etc).
ConnectionString	Uma cadeia de conexão usada para se conectar ao repositório.
ConnectionStringName	Nome de definição da cadeia de conexão definida em um arquivo de configuração.

Opções de sintaxe para o 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>]

A tabela a seguir lista os parâmetros que são específicos ao cmdlet Set-ASAppSqlInstanceStore.

Parâmetro	Descrição
Nome	Nome de definição do repositório de instâncias no arquivo de configuração associado ao escopo especificado (raiz, site, aplicativo, etc).
ConnectionString	Uma cadeia de conexão usada para se conectar ao repositório.
ConnectionStringName	Nome de definição da cadeia de conexão definida em um arquivo de configuração.

Opções de sintaxe para o 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>]

A tabela a seguir lista os parâmetros que são específicos ao cmdlet Remove-ASAppSqlInstanceStore.

Parâmetro	Descrição
Nome	Nome de definição do repositório de instâncias no arquivo de configuração associado ao escopo especificado (raiz, site, aplicativo, etc).

Opções de sintaxe para o 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>]

A tabela a seguir lista os parâmetros que são específicos ao cmdlet Get-ASAppInstanceStore.

Parâmetro	Descrição
Nome	Nome de definição do repositório de instâncias no arquivo de configuração associado ao escopo especificado (raiz, site, aplicativo, etc).

Para inicializar ou remover bancos de dados de persistência SQL Server usando cmdlets

Cmdlet

Descrição

Initialize-ASPersistenceSqlDatabase

Cria e inicializa um banco de dados de persistência SQL Server no servidor de banco de dados especificado se o banco de dados especificado ainda não existir no servidor. O processo de inicialização cria artefatos relacionados à persistência (tabelas, visualizações, procedimentos armazenados, etc). Se o banco de dados já existir no servidor, o cmdlet inicializará o banco de dados com os artefatos de persistência. O cmdlet também adiciona os grupos especificados do Windows às funções correspondentes do SQL Server. Um exemplo de cmdlet:

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

Remove-ASPersistenceSqlDatabase

Remove todos os artefatos de persistência (procedimentos armazenados, tabelas, visualizações, etc) do banco de dados especificado, mas não remove o banco de dados. Um exemplo de cmdlet:

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

Opções de sintaxe para o 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>]

A tabela a seguir lista os parâmetros que são específicos ao cmdlet Initialize-ASPersistenceSqlDatabase.

Parâmetro	Descrição
Server	Nome do servidor no qual o banco de dados reside.
Database	Nome do banco de dados de persistência SQL Server.
ConnectionString	Uma cadeia de conexão usada para se conectar a um banco de dados de persistência SQL Server. Você pode especificar um servidor ou banco de dados ou especificar uma cadeia de conexão que é usada para se conectar a um banco de dados de persistência SQL Server.
Admins	Adiciona o grupo especificado do Windows às funções InstanceStoreObservers, WorkflowActivationUsers, WorkflowAdministrators e WorkflowManagementServiceUsers no banco de dados de persistência SQL Server especificado.
Readers	Adiciona o grupo especificado do Windows à função InstanceStoreObservers no banco de dados de persistência SQL Server especificado.
Users	Adiciona o grupo especificado do Windows à função InstanceStoreUsers no banco de dados de persistência SQL Server especificado.

Opções de sintaxe para o cmdlet Remove-ASPersistenceSqlDatabase

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

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

A tabela a seguir lista os parâmetros que são específicos ao cmdlet Remove-ASPersistenceSqlDatabase.

Parâmetro	Descrição
Server	Nome do servidor no qual o banco de dados reside.
Database	Nome do banco de dados de persistência SQL Server.
ConnectionString	Uma cadeia de conexão usada para se conectar a um banco de dados de persistência SQL Server. Você pode especificar um servidor ou banco de dados ou especificar uma cadeia de conexão que é usada para se conectar a um banco de dados de persistência SQL Server.

2011-12-05

Compartilhar via