Partilhar via

Configuração com script do AppFabric

  • Artigo

Este exemplo orienta você na série de ações necessárias para configurar o AppFabric para usar contas de domínio junto com a autenticação de segurança integrada para conexão a um banco de dados remoto.

Dica

Os exemplos são fornecidos apenas para fins educacionais. Eles não devem ser usados em um ambiente de produção e não foram testados em um ambiente de produção. A Microsoft não oferece suporte técnico para esses exemplos.

Pré-requisitos

Você deve estar familiarizado com os scripts do Windows PowerShell e com conceitos gerais de criação de scripts, além do modelo de segurança do AppFabric. O exemplo pressupõe o seguinte:

  • que a instalação padrão do AppFabric tenha sido realizada

  • que os bancos de dados tenham sido preparados (Os bancos de dados de monitoramento e persistência foram inicializados com as configurações de segurança adequadas em um computador remoto.)

    • Os bancos de dados podem ser preparados usando os seguintes cmdlets: Initialize-ASMonitoringDatabase, Initialize-ASPersistenceSqlDatabase.

    • Os bancos de dados podem ser personalizados no script editando as variáveis $Persistence_ConnectionStringName, $Persistence_ConnectionString, $Monitoring_ConnectionString e $Monitoring_ConnectionStringName na seção Variáveis definidas pelo usuário do exemplo.

  • Que os usuários e grupos do domínio foram criados. O exemplo é previamente preenchido com valores que correspondem à tabela a seguir.

Domínio: corp.contoso.com

Função AppFabric Grupo de domínio Usuário do domínio

Administradores

AS_Administrators

dubAdmin

Users

AS_Users

dubUser

Observadores

AS_Observers

dubObserver

  • Os usuários da função Administrador devem ter privilégios "Login como um serviço", pois eles serão usados para executar os serviços de coleta de eventos e de gerenciamento de fluxo de trabalho.

  • A identidade do pool de aplicativos usado para executar aplicativos do AppFabric deve ser membro da função Usuários.

  • O pool de aplicativos deve ser um pool de aplicativos do .NET Framework 4.

Localização do exemplo e arquivos

Os arquivos de exemplo são os seguintes:

  • Readme.mhtml

  • code\scriptedConfigurationOfDublin.ps1

  • code\scriptedUnconfigurationOfDublin.ps1

Configurando e executando esse exemplo

Para executar este script:

  1. Abra um prompt de comando como administrador.

  2. Navegue até a pasta que contém os arquivos .ps1 de exemplo.

  3. Execute o seguinte comando: powershell -ExecutionPolicy RemoteSigned -File scriptedConfigurationOfDublin.ps1

Noções básicas sobre esse exemplo

O script tem quatro funções e três seções.

Funções

  • GetUserCredential solicita que o usuário forneça um nome de usuário e uma senha e armazena as informações de forma segura em um objeto PSCredential a ser usado no script.

  • SetServiceCredential modifica o logon e a senha do usuário para um serviço específico.

  • GetSqlConnectionString gera uma cadeia de conexão SQL com o servidor e o banco de dados especificados.

  • UpdateConnectionString adiciona ou atualiza a cadeia de conexão especificada ao arquivo de configuração raiz web.config.

Seções

  • Na seção Variáveis Definidas pelo Usuário, você pode encontrar a lista de variáveis usadas no script. Você pode modificar essas variáveis para personalizar o script com as especificidades do ambiente.

  • Na seção Coletar Credenciais, o script chama a função GetUserCredential para obter as credenciais do usuário para uso na configuração dos serviços do sistema (serviço de Gerenciamento de Fluxo de Trabalho e serviço Coleta de Eventos).

  • Na seção Atualizar Configuração, a configuração é aplicada de acordo com as variáveis definidas e as informações coletadas.

O script executa as seguintes ações de configuração:

  1. Adicione o usuário Administrador do AppFabric ao grupo Administradores local.

  2. Defina a configuração do serviço Coleta de Eventos

  3. Defina a configuração do serviço Gerenciamento de Fluxo de Trabalho

  4. Adicione cadeias de conexão à seção de cadeias de conexão no arquivo raiz web.config.

  5. Crie um item no Repositório de Instâncias para a cadeia de conexão de persistência.

  6. Defina o comportamento de persistência.

  7. Defina o comportamento de monitoramento.

Removendo esse exemplo

Para reverter a configuração, execute scriptedUnConfigurationOfDublin.ps1.

powershell -ExecutionPolicy RemoteSigned -File scriptedUnConfigurationOfDublin.ps1

Esse script executa as seguintes ações:

  1. Excluir o usuário Administrador do AppFabric do grupo Administradores local.

  2. O usuário Administrador precisa ser personalizado no script de desconfiguração para coincidir com o usuário personalizado usado na configuração.

  3. Reverter a configuração do serviço Coleta de Eventos

  4. Reverter a configuração do serviço Gerenciamento de Fluxo de Trabalho

  5. Excluir o comportamento de persistência.

  6. Excluir o registro do Repositório de Instâncias da cadeia de conexão de persistência.

Depois de executar o script, você deve excluir manualmente o comportamento de monitoramento do arquivo raiz web.config.

<default enabled="true" connectionStringName="monitoringDB" monitoringLevel="HealthMonitoring" />

Todas as cadeias de conexão acrescentadas pelo script de configuração também devem ser excluídos manualmente.

  2011-12-05