Partilhar via


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

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 Microsoft AppFabric 1.1 para Windows Server, inserir o cmdlet adequado e pressionar ENTER. Para obter mais informações sobre como executar cmdlets gerais do AppFabric, consulte Executando Cmdlets do 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 piping (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

Servidor

Nome do servidor no qual o banco de dados reside.

Banco de Dados

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.

Leitores

Adiciona o grupo especificado do Windows à função InstanceStoreObservers no banco de dados de persistência SQL Server especificado.

Usuários

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

Servidor

Nome do servidor no qual o banco de dados reside.

Banco de Dados

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.

  2012-03-05