Scripts do PowerShell para Automatizar a Instalação da Ferramenta de Implantação da Web

por Kristina Olson

A versão v2.1 da Implantação da Web instala vários scripts do PowerShell que facilitam a configuração do servidor IIS para que os usuários possam publicar nele usando a Implantação da Web. Esta página mostra como usar esses scripts para criar um site de publicação padrão, habilitar a publicação para um site e usuário novos ou existentes, criar bancos de dados SQL ou MySQL de publicação ou configurar regras de delegação – tudo isso usando o PowerShell.

Os scripts que você usará são:

• SetupSiteForPublish.ps1
• CreateSqlDatabase.ps1
• CreateMySqlDatabase.ps1
• AddDelegationRules.ps1

Requisitos

• O servidor deve ter um sistema operacional que venha com o IIS7 – o que significa o Windows Server 2008 ou o Windows Server 2008 R2. Você precisa ser um administrador no computador.

• Confirme se todas as seguintes condições foram atendidas:

  • O PowerShell2 precisa ser instalado (isso é integrado ao Windows Server 2008 R2; para o Windows Server 2008, você pode obter o PowerShell2 como uma atualização aqui: https://www.catalog.update.microsoft.com/ScopedViewInline.aspx?updateid=0be83604-db27-4b99-976a-136a92bd579b. Pode ser necessário reiniciar.
  • A função de Servidor Web (IIS) deve estar habilitada no Gerenciador do Servidor.
  • O serviço de função do Serviço de Gerenciamento da Web do IIS ("Serviço de Gerenciamento") deve estar habilitado no Gerenciador do Servidor
  • Para usar os scripts de banco de dados do PowerShell, o servidor deve ter acesso a um banco de dados SQL ou MySQL. Os SQL Server Management Objects também precisam estar instalados para SQL.
  • A Implantação da Web precisa estar instalada com o componente de Integração do Serviço de Gerenciamento. (Para que essa opção apareça no instalador da Implantação da Web, o Serviço de Gerenciamento da Web precisa ser habilitado primeiro.)

Instruções gerais do PowerShell

1. Inicialize a janela de comando do PowerShell.

   Clique no ícone do PowerShell na barra de tarefas ou clique em Iniciar, digite PowerShell e selecione Windows PowerShell.
   
   (O ícone azul)

2. Verifique se a política de execução permite a execução de scripts.

   1. Digite "Get-ExecutionPolicy". Se for Restrito (o padrão), você precisará redefinir para uma configuração mais permissiva, como digitando "Set-ExecutionPolicy AllSigned". A configuração AllSigned permitirá a execução de scripts assinados, mas fará uma solicitação a você caso eles não sejam confiáveis

   2. Para saber mais sobre as configurações da política de execução, confira Usando o Cmdlet Set-ExecutionPolicy.

3. Altere para o diretório de scripts da Implantação da Web.

   1. Digite cd '%programfiles%\IIS\Microsoft Web Deploy v2\Scripts' (mas substitua %programfiles% pelo caminho real, como C:\Program Files).

Use o script SetupSiteForPublish para criar um site de publicação padrão (sem bancos de dados)

Execute o script SetupSiteForPublish.ps1 sem argumentos:

O que isso faz:

O script cria um usuário e um site para publicação não administrativa e salva as informações do perfil de publicação em um arquivo na área de trabalho. Mais especificamente, ele cria um site chamado WDeploySite com a raiz de site física em %systemdrive%\inetpub\WDeploySite. O site terá um pool de aplicativos correspondente, WDeployAppPool, e será atribuído à porta 8080 por padrão (ou à próxima porta disponível se outro site estiver usando 8080). O script também cria um usuário local do Windows não administrador chamado WDeploySiteuser e concede a esse usuário ACLs de Controle Total na pasta WDeploySite e Permissões do Gerenciador do IIS para o site. As informações de configurações são salvas na área de trabalho em um arquivo chamado WDeploy.PublishSettings – esse arquivo pode ser consumido pelo WebMatrix (ou potencialmente pelo Visual Studio) para publicação no site. Esse perfil NÃO contém nenhuma informação de publicação de banco de dados neste momento.

Habilite a Publicação da Implantação da Web para qualquer Site e Usuário usando o script SetupSiteForPublish:

Script: SetupSiteForPublish.ps1

Descrição: para um site e uma conta de usuário especificados, permite que o usuário especificado publique no site especificado. O script cria a conta de usuário, o site e o pool de aplicativos; define as ACLs do diretório e as permissões do Gerenciador do IIS para o site e salva as informações de configuração em um arquivo.

Parâmetros:

Exemplos:

Habilite a publicação para um usuário existente em um site existente (a senha não será salva no arquivo de configurações):

.\SetupSiteForPublish.ps1 -siteName ExistingSite -deploymentUserName UserA -publishSettingSavePath C:\profiles -publishSettingFileName UserA.PublishSettings

Habilite a publicação para um novo usuário em um novo site, com um nome e um local personalizados para o arquivo de configurações de publicação:

.\SetupSiteForPublish.ps1 -siteName NewSite -sitePhysicalPath C:\inetpub\NewSiteRoot -siteAppPoolName NewSitePool -sitePort 81 -deploymentUserName NewSiteUser -deploymentUserPassword Passw0rd -publishSettingSavePath C:\profiles -publishSettingFileName NewSite.PublishSettings

O arquivo PublishSettings também contém a nova senha de usuário. Observe que os campos da cadeia de conexão estão vazios – eles podem ser preenchidos manualmente ou você pode adicionar isso ao perfil usando os scripts de geração de banco de dados:

<?xml version="1.0" encoding="utf-8"?>
<publishData>
  <publishProfile publishUrl="RWS-2008R2" msdeploySite="NewSite" destinationAppUrl="http://RWS-2008R2:81" mySQLDBConnectionString="" SQLServerDBConnectionString="" profileName="Default Settings" publishMethod="MSDeploy" userName="NewSiteUser" userPWD="Passw0rd" savePWD="True" />
</publishData>

Criar um banco de dados SQL para uma conta de publicação usando o script CreateSqlDatabase

Script: CreateSqlDatabase.ps1

Descrição: cria um banco de dados, um logon, um usuário de banco de dados que tem as permissões db_owner para o banco de dados e salva as informações de cadeia de conexão correspondentes em um arquivo de configurações.

Parâmetros:

Geral

Exemplos:

Crie um banco de dados com o usuário usando os padrões (banco de dados SQLExpress local):

.\CreateSqlDatabase.ps1

Crie um banco de dados e adicione as informações da cadeia de conexão ao arquivo de configurações de publicação existente c:\profiles\UserA.PublishSettings:

PS C:\Program Files\IIS\Microsoft Web Deploy V2\Scripts> .\CreateSqlDatabase.ps1 -databaseName UserADb -databaseUserName UserADbUser -databaseUserPassword Passw0rdA -databaseAdminUser sa -databaseAdminPassword Passw0rd -sqlServerInstanceName .\SQLExpress -publishSettingSavePath C:\profiles -publishSettingFileName UserA.PublishSettings

Criar um banco de dados MySQL para uma conta de publicação usando o script CreateMySqlDatabase

Script: CreateMySqlDatabase.ps1

Descrição: cria um banco de dados, um usuário de banco de dados com todos os privilégios no banco de dados (no localhost) e salva as informações da cadeia de conexão em um arquivo de configurações

Parâmetros:

Geral:

*Se você especificar um valor diferente de localhost para serverHostName e não modificar as permissões para o usuário, talvez o usuário não consiga acessar seu banco de dados. Por padrão, as permissões concedidas nesse script fornecem ao usuário do banco de dados acesso do computador local. Se o servidor de banco de dados não estiver hospedado na mesma máquina, a seção de concessão de permissão do script do PowerShell deverá ser modificada para conceder permissões mais gerais, por exemplo, alterar a seguinte linha de script para permitir o acesso de qualquer computador:

Linha de permissões de script padrão:

$createUserScript = "Grant all privileges on {0}.* to '{1}'@'localhost' identified by '{2}';"

Linha de permissões de script modificada:

$createUserScript = "Grant all privileges on {0}.* to '{1}'@'%' identified by '{2}';"

Exemplos:

Crie um banco de dados com o usuário usando os padrões:

.\CreateMySqlDatabase.ps1

Crie um banco de dados e adicione as informações da cadeia de conexão ao arquivo de configurações de publicação existente c:\profiles\UserA.PublishSettings:

.\CreateMySqlDatabase.ps1 -databaseName UserADb -databaseUsername UserADbUser -databaseUserPassword Passw0rd -databaseAdminUser root -databaseAdminPassword iis6!dfu -publishSettingSavePath C:\profiles -publishSettingFileName UserA.PublishSettings

Configurar regras de delegação para o servidor usando o script AddDelegationRules

Script: AddDelegationRules.ps1

Descrição: este script é executado automaticamente no momento da instalação pelo instalador durante uma instalação completa, mas se você não fez uma instalação completa ou deseja reparar as regras a qualquer momento, pode executar novamente este script AddDelegationRules.

Parâmetros: