Compartilhar via

Instalar o SharePoint Foundation 2010 usando o Windows PowerShell

  • Artigo

 

Aplica-se a: SharePoint Foundation 2010

Tópico modificado em: 2016-11-30

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

Neste artigo:

  • Requisitos do servidor de farm

  • Preparar o SPModule

  • Instalar o SharePoint Foundation 2010 executando o Install-SharePoint

  • Configurar o farm usando o New-SharePointFarm

  • Criar um aplicativo Web com o uso do Windows PowerShell

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

  • Criar um conjunto de sites usando o Windows PowerShell

  • Executar tarefas adicionais de configuração

  • Adicionar servidores ao farm usando o Join-SharePointFarm

  • Configurar o log de rastreamento

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

Requisitos do servidor de farm

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

  1. Certifique-se de ter cumprido todos os requisitos de hardware e software. Você deve ter uma versão de 64 bit do Windows Server 2008 ou Windows Server 2008 R2. Para farms de servidores, você também deve ter uma versão de 64 bits do SQL Server 2005 ou SQL Server 2008. For more information about these requirements (such as specific updates that you must install), see Determine hardware and software requirements (SharePoint Foundation 2010).

  2. Certifique-se de estar preparado para configurar as contas exigidas, usando as permissões apropriadas. For detailed information, see Administrative and service accounts required for initial deployment (SharePoint Foundation 2010).

Preparar o 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, siga estas etapas:

  1. Baixe o SPModule.zip e o arquivo de texto da seguinte 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 para os locais 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á ter dois arquivos: SPModule.misc e SPModule.setup.

    Observação

    Se a pasta SPModule não for 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 diretiva de execução do Windows PowerShell está definida como Restrita, o que impede a execução de scripts. Para alterar uma diretiva desse tipo, execute o cmdlet Set-ExecutionPolicy. Para obter informações adicionais sobre diretivas 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, selecione Todos os Programas e clique em Windows PowerShell V2. Depois que a janela de Prompt de Comando do Windows PowerShell for aberta, a primeira coisa a fazer será adicionar o caminho para o módulo ao caminho do seu módulo do Windows PowerShell (supondo 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 Foundation 2010, você poderá abrir o Shell de Gerenciamento do SharePoint 2010.

    3. Depois que a janela de Prompt de Comando for exibida, precisaremos importar o módulo para a sessão atual do Windows PowerShell e adicioná-lo a um caminho digitando a sintaxe a seguir no 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 saber se há uma nova versão disponível. Se você receber uma notificação confirmando essa disponibilidade, baixe a versão mais recente. Depois que os comandos Import-Module forem concluídos com êxito, você estará pronto para usar o SPModule.

Importante

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

  1. Install-SharePoint: instala todos os arquivos binários do SharePoint Foundation 2010. Para obter mais informações, consulte Scripted deployment reference (SharePoint Foundation 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.

    • Instala todos os arquivos de Ajuda do produto.

    • Instala todos os recursos do farm.

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

Depois que a versão 2.0 do Windows PowerShell for instalada, use um novo recurso do Windows PowerShell chamado Comunicação Remota. Usando o recurso de comunicação remota 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 SharePoint Foundation 2010 executando o Install-SharePoint

Depois de determinar as contas necessárias para a instalação, você pode instalar o SharePoint Foundation 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 sem confirmação

SetupFarmUpgrade\Config.xml

Atualização in-loco 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 in-loco 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 Foundation 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 mostrado a seguir:

    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 sem confirmação (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 a um arquivo de log, <Logging Type="off" | "standard"(default) | "verbose" Path="path" Template="file name.log"/>, em que 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 Install-SharePoint usando uma chave PID

Para executar a Instalação no modo sem confirmação sem 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" -ServerRole "SINGLESERVER"

  • Para uma implantação de farm: Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe"

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:

  • Para um servidor autônomo: Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\singleserver_config.xml" -ServerRole "SINGLESERVER"

  • Para uma implantação de farm: Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\appserver_config.xml"

Observação

Para o Microsoft SharePoint Foundation 2010, o parâmetro PIDKey não precisa ser especificado.

Configurar o farm usando o New-SharePointFarm

Você usa o comando New-SharePointFarm para configurar o SharePoint Foundation 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 Foundation 2010 em um servidor autônomo ou em um farm de servidores.

Configurar o SharePoint Foundation 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 Foundation 2010.

Para configurar o SharePoint Foundation 2010 em um servidor autônomo usando o 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 do 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 Foundation 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 de 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 existente e ingressar o servidor em um farm de servidores existente, o cmdlet Connect–SPConfigurationDatabase deve ser executado em conjunto com os seguintes cmdlets do Windows PowerShell, nesta ordem:

  • Install-SPHelpCollection

  • Initialize-SPResourceSecurity

  • Install-SPService

  • Install-SPFeature -AllExistingFeatures

  • Install-SPApplicationContent

Criar um aplicativo Web com o uso do Windows PowerShell

Use o cmdlet New-SPWebApplication para criar o aplicativo Web e um novo banco de dados de conteúdo.

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 -ApplicationPool <String> -Name 
<InternetSite>
 -ApplicationPoolAccount (Get-SPManagedAccount 
<DOMAIN\UserName>

    Em que:

    • <String> é o nome do pool de aplicativos. Por exemplo, "SharePoint -80".

    • <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 os 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 Foundation 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 de usuário 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 de modelos comuns do SharePoint Foundation 2010, consulte Scripted deployment reference (SharePoint Foundation 2010)

Se você desejar 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 Foundation 2010 (enquanto navegam para a home page de um site do SharePoint, por exemplo). Eles habilitam o SharePoint Foundation 2010 a mapear solicitações da Web aos aplicativos Web e sites corretos, e permitem que o SharePoint Foundation 2010 apresente o conteúdo correto ao usuário. Para obter mais informações, consulte Set-SPAlternateUrl.

Executar tarefas adicionais de configuração

Depois de instalar o SharePoint Foundation 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 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 ingressar o servidor em um farm de servidores, digite o seguinte comando no servidor (depois da instalação do SharePoint Foundation 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 formato DOMÍNIO\senha.

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 Foundation 2010 antes do problema ocorrer.

Por padrão, o SharePoint Foundation 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 o log de diagnóstico, consulte Configure diagnostic logging (SharePoint Foundation 2010)