Instalar o SQL Server usando um arquivo de configuração

  • Artigo

Aplica-se a: SQL Server - somente Windows

A Instalação do SQL Server pode gerar um arquivo de configuração baseado no padrão do sistema e em entradas de tempo de execução. É possível usar o arquivo de configuração para implantar o SQL Server em toda a empresa com a mesma configuração. Também é possível padronizar instalações manuais em toda a empresa criando um arquivo em lotes que inicie o Setup.exe.

Este artigo é mantido para versões do SQL Server 2016 e posterior. Para versões anteriores do SQL Server, consulte Instalar o SQL Server 2014 usando um arquivo de configuração.

A Instalação dá suporte ao uso do arquivo de configuração apenas por meio do prompt de comando. A ordem de processamento dos parâmetros ao usar o arquivo de configuração é descrita a seguir:

  • O arquivo de configuração substitui os padrões em um pacote

  • Os valores da linha de comando substituem os valores do arquivo de configuração

O arquivo de configuração pode ser usado para acompanhar os parâmetros e valores de cada instalação. Isto torna o arquivo de configuração útil para verificar e auditar as instalações.

Dica

Como as opções de configuração podem mudar de versão para versão, é melhor gerar um novo ConfigurationFile.ini para cada nova versão do SQL Server.

Estrutura do arquivo de configuração

O arquivo ConfigurationFile.ini é um arquivo de texto com parâmetros (par de nome/valor) e comentários descritivos.

Segue um exemplo de um arquivo ConfigurationFile.ini :

; Microsoft SQL Server Configuration file
[OPTIONS]
; Specifies a Setup work flow, like INSTALL, UNINSTALL, or UPGRADE.
; This is a required parameter.
ACTION="Install"
; Specifies features to install, uninstall, or upgrade.
; The list of top-level features include SQL, AS, RS, IS, and Tools.
; The SQL feature will install the database engine, replication, and full-text.
; The Tools feature will install Management Tools, Books online,
; SQL Server Data Tools, and other shared components.
FEATURES=SQL,Tools

; Microsoft SQL Server Configuration file
[OPTIONS]
; Specifies a Setup work flow, like INSTALL, UNINSTALL, or UPGRADE.
; This is a required parameter.
ACTION="Install"
; Specifies features to install, uninstall, or upgrade.
; The list of top-level features include SQL, AS, and IS.
; The SQL feature will install the database engine, replication, and full-text.
FEATURES=SQL

Como gerar um arquivo de configuração

  1. Insira a mídia de instalação do SQL Server . Na pasta raiz, clique duas vezes em Setup.exe. Para instalar a partir de um compartilhamento de rede, localize a pasta raiz no compartilhamento e clique duas vezes em Setup.exe.

    Observação

    SQL Server Express Edition não cria um arquivo de configuração automaticamente. O comando a seguir iniciará a instalação e criará um arquivo de configuração.

    SETUP.exe /UIMODE=Normal /ACTION=INSTALL

  2. Conclua o assistente até a página Pronto para Instalar . O caminho para o arquivo de configuração é especificado na página Pronto para Instalar na seção do caminho do arquivo de configuração. Para obter mais informações sobre como instalar o SQL Server, confira Instalar o SQL Server por meio do Assistente de Instalação (Instalação).

  3. Cancele a instalação sem realmente concluí-la para gerar o arquivo INI.

    Observação

    A infraestrutura da instalação gravará todos os parâmetros adequados para as ações que foram executadas, com exceção de informações confidencias, como senhas. O parâmetro /IAcceptSQLServerLicenseTerms também não é gravado no arquivo de configuração e requer uma modificação do arquivo de configuração ou um valor a ser fornecido no prompt de comando. Para obter mais informações, consulte Instalar o SQL Server por meio do prompt de comando. Além disso, um valor é incluído para os parâmetros boolianos onde um valor geralmente não é fornecido por meio do prompt de comando.

A partir do SQL Server 2022 (16.x), leia os Termos de Licença do Software Microsoft SQL Server em aka.ms/useterms.

Usar o arquivo de configuração para instalar o SQL Server

É possível usar o arquivo de configuração apenas em instalações de linha de comando.

Observação

Se você precisar fazer alterações no arquivo de configuração, é recomendável fazer uma cópia e trabalhar com a cópia.

Como usar um arquivo de configuração para instalar uma instância autônoma do SQL Server

  • Execute a instalação por meio do prompt de comando e forneça o ConfigurationFile.ini usando o parâmetro ConfigurationFile.

Como usar um arquivo de configuração para preparar e concluir uma imagem de uma instância autônoma do SQL Server (SysPrep)

  1. Para preparar uma ou mais instâncias do SQL Server e configurá-las na mesma máquina.

    • Execute Preparação de imagem de uma instância autônoma do SQL Server na página Avançado da Central de Instalação e capture o arquivo de configuração da preparação de imagem.

    • Use o mesmo arquivo de configuração de preparação de imagem como um modelo para preparar mais instâncias do SQL Server.

    • Execute Conclusão de imagem de uma instância autônoma preparada do SQL Server na página Avançado da Central de Instalação para configurar instância preparada no computador.

  2. Para preparar uma imagem do sistema operacional incluindo uma instância preparada não configurada do SQL Server, usando a ferramenta SysPrep do Windows.

    • Execute a Preparação de imagem de uma instância autônoma do SQL Server na página Avançado da Central de Instalação e capture o arquivo de configuração da preparação de imagem.

    • Execute a Conclusão de imagem de uma instância autônoma preparada do SQL Server na página Avançado da Central de Instalação, mas cancele-a na página Pronto para Concluir depois de capturar o arquivo de configuração completo.

    • O arquivo de configuração de imagem completo pode ser armazenado com a imagem do Windows para automatizar a configuração das instâncias preparadas.

Como instalar um cluster de failover do SQL Server usando o arquivo de configuração

  1. Opção de Instalação Integrada (criar um único cluster de failover de nó em um nó e, para nós adicionais, executar AddNode neles):

    • Execute a opção "Instalar um Cluster de Failover" e capture o arquivo de configuração que lista todas as configurações de instalação.

    • Execute a instalação de cluster de failover de linha de comando fornecendo o parâmetro ConfigurationFile.

    • Em um nó adicional a ser adicionado, execute AddNode para capturar o arquivo ConfigurationFile.ini aplicável ao cluster de failover existente.

    • Execute o AddNode de linha de comando em todos os nós adicionais que serão unidos ao cluster de failover fornecendo o mesmo arquivo de configuração usando o parâmetro ConfigurationFile.

  2. Opção de Instalação avançada (preparar cluster de failover em todos os nós de cluster de failover e, após preparar todos os nós, execução completa no nó que possui o disco compartilhado):

    • Execute Preparar em um dos nós e capture o arquivo ConfigurationFile.ini.

    • Forneça o mesmo arquivo ConfigurationFile.ini para executar a Instalação em todos os nós que serão preparados para o cluster de failover.

    • Após a preparação de todos os nós, execute uma operação de cluster de failover completa no nó que possui o disco compartilhado e capture o arquivo ConfigurationFile.ini.

    • Em seguida, você pode fornecer esse arquivo ConfigurationFile.ini para concluir o cluster de failover.

Como adicionar ou remover um nó de um cluster de failover do SQL Server usando o arquivo de configuração

  • Se você tiver um arquivo de configuração que foi usado anteriormente para adicionar um nó ou para remover um nó de um cluster de failover, poderá reutilizar esse mesmo arquivo para adicionar ou remover nós adicionais.

Como atualizar um cluster de failover do SQL Server com o arquivo de configuração

  1. Execute Atualizar no nó passivo e capture o arquivo ConfigurationFile.ini. Isso pode ser feito executando a atualização real ou saindo no final sem fazer a atualização real.

  2. Em todos os nós adicionais a serem atualizados, forneça o arquivo ConfigurationFile.ini para concluir o processo.

Sintaxe de exemplo

Os exemplos a seguir mostram como usar o arquivo de configuração:

  • Para especificar o arquivo de configuração no prompt de comando:
Setup.exe /ConfigurationFile=MyConfigurationFile.ini
  • Para especificar senhas no prompt de comando em vez de no arquivo de configuração:
Setup.exe /SQLSVCPASSWORD="************" /AGTSVCPASSWORD="************" /ASSVCPASSWORD="************" /ISSVCPASSWORD="************" /RSSVCPASSWORD="************" /ConfigurationFile=MyConfigurationFile.ini

Setup.exe /SQLSVCPASSWORD="************" /AGTSVCPASSWORD="************" /ASSVCPASSWORD="************" /ISSVCPASSWORD="************" /ConfigurationFile=MyConfigurationFile.ini

Confira também