Instalar o SharePoint Server 2010 usando o Windows PowerShell

 

Aplica-se a: SharePoint Foundation 2010, SharePoint Server 2010

Tópico modificado em: 2016-11-30

Este artigo discute como fazer uma instalação limpa do Microsoft SharePoint Server 2010, em um servidor autônomo ou em um farm de servidores, usando o Windows PowerShell.

Visão geral do processo de instalação:

  • Preparar SPModule

  • Requisitos do servidor do farm

  • Instalar o Microsoft SharePoint Server 2010 executando Install-SharePoint

  • Configurar o farm usando o comando New-SharePointFarm

  • Criar um aplicativo Web usando o Windows PowerShell

  • Implantar serviços usando o Assistente de Configuração do Farm do SharePoint 2010

  • Criar um conjunto de sites usando o Windows PowerShell

  • Executar tarefas de configuração adicionais

  • Adicionar servidores ao farm usando o comando Join-SharePointFarm

  • Configurar o log de rastreamento

Você pode simplificar a implantação usando o Windows PowerShell para instalar o Microsoft SharePoint Server 2010, em combinação com outras ferramentas do administrador, para automatizar instalações autônomas e configurar o farm.

Requisitos do servidor do farm

Antes de instalar o SharePoint Server 2010, examine as seguintes informações sobre permissões e requisitos de hardware e software e as etapas a serem executadas antes de iniciar o processo:

Preparar SPModule

O arquivo SPModule.zip é um módulo do Windows PowerShell criado pelos membros do Grupo de Produtos do SharePoint que instalarão um farm do SharePoint.

Para usar o arquivo SPModule.zip, execute as etapas a seguir:

  1. Baixe o SPModule.zip e o arquivo de texto desta página do Centro de Download (https://go.microsoft.com/fwlink/?linkid=187924&clcid=0x416).

  2. Extraia os arquivos para uma pasta denominada SPModule e adicione essa pasta ao caminho do ambiente. A variável de ambiente PSModulePath é usada para armazenar os caminhos de localização dos módulos que estão instalados em disco. Para exibir os caminhos especificados na variável PSModulePath, em um prompt de comando do Windows PowerShell, digite $env:PSModulePath. Para obter mais informações, consulte Variável de Ambiente PSModule (https://go.microsoft.com/fwlink/?linkid=187757&clcid=0x416). Depois da extração, a pasta SPModule deverá conter dois arquivos: SPModule.misc e SPModule.setup.

    Observação

    Se a pasta SPModule não estiver adicionada à variável PSModulePath, especifique o caminho completo para carregar o SPModule.

  3. Escolha o tipo de assinatura que será fornecida.

    Observação

    Os arquivos baixados não são assinados. Para fornecer scripts autoassinados, consulte AllSigned: Assinando Scripts do PowerShell (https://go.microsoft.com/fwlink/?linkid=187758&clcid=0x416).

    Por padrão, a política de execução do Windows PowerShell está definida como Restrita, o que impede a execução de scripts. Para alterar uma política desse tipo, execute o cmdlet Set-ExecutionPolicy. Para obter informações adicionais sobre políticas de execução, consulte About_Signing (https://go.microsoft.com/fwlink/?linkid=187759&clcid=0x416).

  4. Carregue os arquivos SPModule.misc e SPModule.setup para o Windows PowerShell.

    1. Clique em Iniciar, aponte para Todos os Programas e clique em Windows PowerShell V2. Quando a janela do Prompt de Comando do Windows PowerShell estiver aberta, a primeira coisa a fazer será adicionar o caminho do módulo ao caminho do seu módulo do Windows PowerShell (presumindo que você tenha criado uma pasta denominada "SPModule" no servidor):

    2. Clique com o botão direito do mouse em Windows PowerShell V2 e selecione Executar como administrador.

      Observação

      Caso já tenha instalado o Microsoft SharePoint Server 2010, você poderá optar por usar o SharePoint 2010 Management Shell em vez disso.

    3. Uma vez exibida a janela do Prompt de Comando, será necessário importar o módulo para a sessão atual do Windows PowerShell e adicioná-lo a um caminho, digitando a seguinte sintaxe em um prompt de comando do Windows PowerShell:

      Import-Module SPModule.misc
      
      Import-Module SPModule.setup
      

Ao importar o módulo SPModule.misc, você chamará uma verificação de atualizações. Na versão 1.0, ela verificará um arquivo de texto para ver se há uma nova versão disponível. Se você receber uma notificação confirmando essa disponibilidade, baixe a versão mais recente. Depois da conclusão bem-sucedida dos comandos Import-Module, você está pronto para usar o SPModule.

Importante

Os seguintes comandos devem ser usados no contexto do SPModule e do processo neste artigo.

  1. Install-SharePoint: instala todos os arquivos binários do SharePoint Server 2010. Para obter mais informações, consulte Scripted deployment reference (SharePoint Server 2010).

  2. New-SharePointFarm: cria um farm do SharePoint e executa as seguintes tarefas relacionadas:

    • Configura a segurança

    • Cria um aplicativo Web de serviço compartilhado que você pode popular com aplicativos de serviço.

    • Cria e configura o site da Administração Central do SharePoint:

    • Instala todos os arquivos de Ajuda do produto.

    • Instala todos os recursos do farm.

    Para obter mais informações, consulte Scripted deployment reference (SharePoint Server 2010).

  3. Join-SharePointFarm: adiciona servidores ao farm e os configura. Para obter mais informações, consulte Scripted deployment reference (SharePoint Server 2010).

Depois da instalação do Windows PowerShell versão 2.0, você pode usar um novo recurso do Windows PowerShell denominado Comunicação Remota. Com esse recurso e algumas linhas de código do Windows PowerShell, um administrador pode instalar remotamente vários servidores em um farm. Para obter mais informações sobre a Comunicação Remota e o SPModule, consulte Instalação Remota com o SPModule (https://go.microsoft.com/fwlink/?linkid=187923&clcid=0x416).

Instalar o Microsoft SharePoint Server 2010 executando Install-SharePoint

Depois de determinar as contas necessárias para a instalação, você pode instalar o SharePoint Server 2010. O DVD do produto contém exemplos de arquivos de configuração (Config.xml). Esses arquivos de exemplo estão armazenados na pasta \Files, no diretório raiz do DVD, em pastas que correspondem a diferentes cenários. Eles estão descritos na tabela a seguir.

Arquivo de configuração

Descrição

Setup\Config.xml

Instalação de servidor autônomo, usando o Microsoft SQL Server 2005 Express Edition

SetupFarm\Config.xml

Instalação de farm de servidores

SetupFarmSilent\Config.xml

Instalação de farm de servidores em modo silencioso

SetupFarmUpgrade\Config.xml

Atualização no local de um farm existente

SetupSilent\Config.xml

Instalação de servidor autônomo, usando o SQL Server 2005 Express Edition, no modo sem confirmação

SetupSingleUpgrade\Config.xml

Atualização no local de uma instalação existente de servidor único

Para executar Install-SharePoint com um arquivo Config.xml em um prompt de comando do Windows PowerShell

  1. Na unidade em que está localizado o DVD do produto SharePoint Server 2010, vá para o diretório raiz para localizar o arquivo setup.exe.

  2. Execute SPModule.Setup Install-SharePoint com o arquivo Config.xml selecionado, como segue:

    Install-SharePoint -SetupExePath <caminho e nome do arquivo> -ConfigXml <caminho e nome do arquivo>

    Observação

    Você pode selecionar um dos arquivos de exemplo ou personalizar seu próprio arquivo de configuração.

  3. Pressione ENTER.

A instalação agora está concluída.

O exemplo a seguir mostra o arquivo de configuração para configuração de um único servidor no modo silencioso (SetupSilent).

<Configuration>
<Package Id="sts">
  <Setting Id="LAUNCHEDFROMSETUPSTS" Value="Yes" />
  </Package>
<Package Id="spswfe">
  <Setting Id="SETUPCALLED" Value="1" />
  </Package>
  <Logging Type="verbose" Path="%temp%" Template="SharePoint Server Setup(*).log" />
- <!--
<PIDKEY Value="Enter Product Key Here" />
  -->
  <Display Level="none" CompletionNotice="no" />
  <Setting Id="SERVERROLE" Value="APPLICATION" />
  <Setting Id="USINGUIINSTALLMODE" Value="0" />
  <Setting Id="SETUP_REBOOT" Value="Never" />
  <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL" />
  </Configuration>

Você também pode personalizar seu próprio arquivo de configuração. Para controlar a instalação, primeiro edite o arquivo Config.xml em um editor de texto para incluir os elementos desejados com as configurações adequadas para esses elementos. Em seguida, execute Install-SharePoint -SetupExePath -ConfigXML para especificar que a Instalação seja executada usando as opções definidas no arquivo Config.xml.

Algumas opções de configuração típicas incluem o seguinte:

  • Ignorar o prompt da chave do produto ao fornecer a chave como um valor, <PIDKEY Value="Enter PID Key Here" />, no arquivo Config.xml.

  • Adicionar uma localização para um arquivo de log, <Logging Type="off" | "standard"(default) | "verbose" Path="path" Template="file name.log"/>, na qual seja possível ver se houve alguma falha na instalação por linha de comando.

Importante

Use um editor de texto, como o Bloco de Notas, para editar Config.xml. Não use um editor de XML genérico, como o Microsoft Office Word 2007. Para confirmar se o arquivo XML está formado adequadamente, use qualquer navegador com suporte.

Executar o comando Install-SharePoint usando uma chave PID

Para executar a Instalação no modo sem confirmação e não usar um arquivo XML de configuração, digite um dos seguintes comandos em um prompt de comando do Windows PowerShell:

  • Para um servidor autônomo: Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe" -PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX" -ServerRole "SINGLESERVER"

  • Para uma implantação de farm: Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe" -PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX"

Para executar a Instalação no modo sem confirmação usando um arquivo XML de configuração, digite um dos seguintes comandos em um prompt de comando do Windows PowerShell:

  • Em um servidor autônomo: Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\singleserver_config.xml"-PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX" -ServerRole "SINGLESERVER"

  • Em uma implantação de farm: Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\appserver_config.xml"-PIDKey "PVRYW-RRP8H-FG6G2-YGMQW-3V9VX"

Configurar o farm usando o comando New-SharePointFarm

Você usa o comando New-SharePointFarm para configurar o SharePoint Server 2010 depois da conclusão do comando Install-SharePoint. As opções de configuração são diferentes, dependendo de se você instalará o SharePoint Server 2010 em um servidor autônomo ou em um farm de servidores.

Configurar o SharePoint Server 2010 em um servidor autônomo

Nas implantações de servidor autônomo, você pode executar o comando New-SharePointFarm. Depois de se conectar usando a conta do usuário da Instalação criada e configurada anteriormente, configure o SharePoint Server 2010.

Para configurar o SharePoint Server 2010 em um servidor autônomo usando o comando New-SharePointFarm

  • No prompt de comando do Windows PowerShell, digite o seguinte comando:

    New-SharePointFarm -DatabaseServer <String> -DatabaseAccessAccount <(Get-Credential domain\account)> -FarmName <string>
    

    Em que:

    • <String> é o nome do servidor de banco de dados. Por exemplo, "SQL01"

    • <PSCredential> é o DOMÍNIO\senha da conta de usuário que está executando a instalação.

    • <String> é o nome do farm. Por exemplo, "Farm1"

O comando New-SharePointFarm descreve as etapas de configuração à medida que elas ocorrem e informa a conclusão bem-sucedida da configuração. Em uma instalação de servidor autônomo, essa é a etapa final em uma instalação por linha de comando.

É extremamente recomendado instalar e configurar o SharePoint Server 2010 em todos os servidores do farm antes da criação de sites.

Aviso

Não execute os comandos New-SharePointFarm e Join-SharePointFarm simultaneamente em vários computadores, pois podem ocorrer problemas de contenção e comportamento imprevisível.

Observação

Se qualquer um desses comandos falhar, consulte os arquivos de log de configuração pós-instalação. Esses arquivos estão disponíveis em %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\14\Logs e podem ser identificados pelo prefixo do nome PowerShell_ConfigurationDiagnostics e pela extensão de nome de arquivo .log.

Observação

Os cmdlets do Windows PowerShell mencionados nesta seção devem ser executados por meio do Shell de Gerenciamento do SharePoint 2010.

Para se conectar a um banco de dados de configuração e associar o servidor a um farm de servidores, o cmdlet Connect–SPConfigurationDatabase deve ser executado junto com os seguintes cmdlets do Windows PowerShell, nesta ordem:

  • Install-SPHelpCollection

  • Initialize-SPResourceSecurity

  • Install-SPService

  • Install-SPFeature -AllExistingFeatures

  • Install-SPApplicationContent

Criar um aplicativo Web usando o Windows PowerShell

Use o cmdlet New-SPWebApplication para criar um aplicativo Web e um novo banco de dados de conteúdo. Use o exemplo a seguir para orientá-lo.

Para criar um aplicativo Web

  1. Verifique se você atende aos seguintes requisitos mínimos: Consulte Add-SPShellAdmin.

  2. No menu Iniciar, clique em Todos os Programas.

  3. Clique em Produtos do Microsoft SharePoint 2010.

  4. Clique em Shell de Gerenciamento do SharePoint 2010.

  5. No prompt de comando do Windows PowerShell, digite o seguinte comando:

    New-SPWebApplication -Name <InternetSite> -ApplicationPoolAccount (Get-SPManagedAccount <DOMAIN\UserName>
    

    Em que:

    • <InternetSite> é o nome do aplicativo Web.

    • Domain\UserName é o nome da conta do pool de aplicativos.

Para obter mais informações, consulte New-SPWebApplication.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

Implantar serviços usando o Assistente de Configuração do Farm do SharePoint 2010

Use o Assistente de Configuração de Produtos do SharePoint para implantar serviços na sua instalação. Para obter informações sobre serviços e aplicativos de serviço, consulte Service application and service management (SharePoint Server 2010).

Criar um conjunto de sites usando o Windows PowerShell

Crie o conjunto de sites de nível superior usando o cmdlet New-SPSite. Os cmdlets New-SPSite criam um conjunto de sites, em determinada URL, com um usuário especificado como proprietário do site.

Para criar um conjunto de sites

  1. Verifique se você atende aos seguintes requisitos mínimos: Consulte Add-SPShellAdmin.

  2. No menu Iniciar, clique em Todos os Programas.

  3. Clique em Produtos do Microsoft SharePoint 2010.

  4. Clique em Shell de Gerenciamento do SharePoint 2010.

  5. No prompt de comando do Windows PowerShell, digite o seguinte comando:

    New-SPSite <SiteURL> -OwnerAlias <DOMAIN\UserName>
    

    Em que:

    • <SiteURL> é a URL do novo site.

    • <DOMAIN\UserName> é o nome de logon do proprietário do site.

Para obter mais informações, consulte New-SPSite.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

Se você não especificar o modelo de site a ser usado, os proprietários do site poderão escolher esse modelo quando navegarem para o site pela primeira vez. Use o cmdlet Get-SPWebTemplate para exibir uma lista de modelos.

Para obter uma lista completa dos modelos comuns no SharePoint Server 2010, consulte Referência de Implantação com Script (SharePoint Server).

Para criar conjuntos de sites adicionais usando o Windows PowerShell, use o cmdlet New-SPSite.

Observação

Para criar um novo banco de dados de conteúdo com o novo site, use o cmdlet New-SPContentDatabase ou o cmdlet New-SPSite com o parâmetro ContentDatabase.

Depois de criar os sites, pode ser necessário configurar mapeamentos de acesso alternativos. Esses mapeamentos direcionam os usuários às URLs corretas durante sua interação com o SharePoint Server 2010 (enquanto navegam para a home page de um site do SharePoint, por exemplo). Eles habilitam o SharePoint Server 2010 a mapear solicitações da Web aos aplicativos Web e sites corretos, e permitem que o SharePoint Server 2010 apresente o conteúdo correto ao usuário. Para obter mais informações, consulte Set-SPAlternateUrl.

Executar tarefas de configuração adicionais

Depois de instalar o SharePoint Server 2010, é recomendado executar as seguintes tarefas administrativas:

  • Definir configurações de email de saída.

  • Definir configurações do fluxo de trabalho.

  • Definir configurações do log de diagnóstico.

  • Definir configurações do antivírus.

Adicionar servidores ao farm usando o comando Join-SharePointFarm

Execute o comando Join-SharePointFarm em todos os servidores a serem adicionados ao farm. Para se conectar a um banco de dados de configuração e associar o servidor a um farm de servidores, digite o seguinte comando no servidor (depois da instalação do SharePoint Server 2010):

Join-SharePointFarm -DatabaseServer <String> -ConfigurationDatabaseName <String> -Passphrase <SecureString>

Em que:

  • <String> é o nome do servidor de banco de dados, por exemplo, SQL01.

  • <SecureString> é a senha da conta do usuário no DOMÍNIO\senha do formulário.

Configurar o log de rastreamento

O log de rastreamento pode ser útil para analisar problemas que podem ocorrer. Você pode usar eventos que estão gravados no log de rastreamento para determinar quais alterações de configuração foram feitas no SharePoint Server 2010 antes do problema ocorrer.

Por padrão, o SharePoint Server 2010 salva 14 dias de eventos nos arquivos de log de rastreamento. Isso significa que arquivos de log que contenham eventos anteriores a 14 dias serão excluídos. Use o cmdlet Set-SPLogLevel para configurar todos os logs de diagnóstico.

Você pode usar a página Log de Diagnóstico na Administração Central para configurar o número máximo de arquivos de log de rastreamento que serão mantidos e por quanto tempo (em minutos) os eventos serão capturados para cada arquivo de log.

Você também pode especificar onde os arquivos de log são gravados ou aceitar o caminho padrão usando o cmdlet Set-SPLogLevel.

Arquivos de log de rastreamento podem ajudá-lo a resolver problemas relacionados a mudanças de configuração no serviço de Pesquisa do Microsoft SharePoint Foundation. Como tais problemas nem sempre são descobertos imediatamente, é recomendado salvar todos os arquivos de log de rastreamento que o sistema criar no dia que você fizer essas mudanças. Armazene-os por algum tempo em um local seguro, onde não sejam substituídos. É recomendado armazená-los em uma partição de disco rígido que seja exclusiva para esse tipo de armazenamento.

Para obter informações adicionais sobre logs de diagnóstico, consulte Configure diagnostic logging (SharePoint Server 2010).