Compartilhar via

  • Artigo

Script de configuração do PowerShell (PowerPivot para SharePoint)

Este tópico se destina a administradores de serviço ou do farm do SharePoint que implantam ou mantêm servidores por meio de script do PowerShell. Para obter instruções sobre como usar a Administração Central do SharePoint 2010 para realizar essas mesmas tarefas, consulte Configuração (PowerPivot para SharePoint).

Se você instalou o SQL Server PowerPivot para SharePoint em um SharePoint Server existente que já esteja configurado ou que já seja membro de um farm, a Instalação do SQL Server não criará ou modificará serviços ou aplicativos do SharePoint para que eles funcionem com a implantação do PowerPivot para SharePoint. Para concluir a implantação, você deve realizar as tarefas de configuração por conta própria. Todas as tarefas pós-instalação podem ser feitas via script. Este tópico fornece um modelo e instruções para usar e executar o script.

Este tópico contém as seguintes seções:

Pré-requisitos

Como executar os comandos

Implantar a solução PowerPivot

Ativar o recurso do PowerPivot

Criar um aplicativo de serviço PowerPivot

Iniciar as declarações para o Serviço de Token do Windows

Habilitar e configurar Serviços do Excel

Habilitar o Serviço de Repositório Seguro e configurar a atualização de dados

Aumentar o tamanho de carregamento máximo de um aplicativo Web

Pré-requisitos

Você deve ser administrador local e um administrador de farm para executar os comandos neste tópico.

Como executar os comandos

Os comandos do PowerShell neste tópico são organizados em seções para configurar aspectos específicos da implantação de um PowerPivot para SharePoint. É possível executar cada um dos blocos de comandos individualmente no Shell de Gerenciamento do SharePoint 2010, ou você pode inseri-los em arquivos .ps1.

Para executar cada comando individualmente

  1. No grupo de programas Produtos do Microsoft SharePoint 2010, clique com o botão direito do mouse em Shell de Gerenciamento do SharePoint 2010 e selecione Executar como administrador.

  2. Verifique se há permissões o suficiente, digitando o seguinte comando no shell. O comando deve retornar uma lista de comandos do PowerShell compatíveis com os Serviços do Excel:

    get-help *SPExcel*

Para executar um arquivo .ps1

Também é possível combinar os scripts com um único arquivo .ps1 e definir todas as configurações em uma única operação. Se fizer isso, você deverá alterar temporariamente a política de execução para executar scripts não assinados. As etapas a seguir explicam como fazer isso.

  1. Abra o Console de Gerenciamento do SharePoint 2010 com permissões de administrador.

  2. Execute o seguinte comando para determinar a política de execução. Posteriormente, quando tiver concluído a implantação do PowerPivot para SharePoint, você redefinirá a política de execução para esse valor.

    Get-ExecutionPolicy

  3. Execute o comando a seguir para alterar temporariamente a política de execução e permitir scripts não assinados. Digite Y para confirmar a ação.

    Set-ExecutionPolicy Unrestricted

  4. Digite o nome do arquivo totalmente qualificado para executar o script. Por exemplo, se salvasse o script em um arquivo chamado PowerPivotConfig.ps1, você inseriria a linha a seguir e pressionaria Enter para executá-lo.

    C:\Scripts-ps1\PowerPivotConfig.ps1

  5. Redefina a política de execução para o valor original na etapa 2. Digite Y para confirmar a ação.

    Set-ExecutionPolicy restricted

Para copiar valores da janela do PowerShell

Alguns dos procedimentos neste tópico pedem que você copie IDs da janela do PowerShell. Se você ainda não souber como fazer isso, use as instruções a seguir para saber como.

  1. Abra o Console de Gerenciamento do SharePoint 2010 com permissões de administrador.

  2. Insira um comando que retorne uma GUID (por exemplo, Get-SPServiceInstance)

  3. Clique no ícone do PowerShell no canto superior esquerdo da janela.

  4. Aponte para Editare clique em Marcar.

  5. Com o cursor, selecione uma ID.

  6. Clique no ícone do PowerShell novamente, aponte para Editare clique em Copiar. A ID agora é armazenada na área de transferência. Você pode colá-la em outras instruções de comando que usam a ID como um valor de parâmetro.

Implantar solução PowerPivot

O PowerPivot para SharePoint inclui uma solução global e uma no nível de aplicativo que devem ser implantadas antes de você criar um aplicativo de serviço do PowerPivot. A solução global é implantada pela Instalação do SQL Server. A solução no nível de aplicativo deve ser implantada após a Instalação. Você deve executar esse script para cada aplicativo Web do SharePoint que dará suporte à integração com o recurso do PowerPivot.

Uma alternativa a esse script é usar as instruções no tópico a seguir: Implantar soluções PowerPivot.

Install-SPSolution -Identity PowerPivotWebApp.wsp -AllWebApplications -GACDeployment

Ativar o recurso

A ativação de recurso do PowerPivot é necessária para cada conjunto de sites. Esse script especifica o conjunto de sites raiz de um aplicativo web do SharePoint denominado "somesite". Substitua "somesite" pelo nome real de seu aplicativo web. Observe que se você tivesse criado conjuntos de sites adicionais (por exemplo, um site denominado PowerPivot), a URL seria http://somesite/PowerPivot.

Uma alternativa para esse script é usar as instruções no tópico a seguir: Ativar a integração de recursos do PowerPivot para coleções de sites.

Enable-SPFeature -Identity "PowerPivotSite" -URL http://somesite/
ObservaçãoObservação

Você pode usar o comando Get-SPFeature para exibir uma lista de todos os recursos de escopo de farm, web e site. Executar eses comando mostrará a você o nome e a ID do recurso de farm do PowerPivot e o recurso de conjunto de sites do PowerPivot.

Criar um aplicativo de serviço PowerPivot

Criar um aplicativo de serviço do PowerPivot fornece um ponto de extremidade HTTP para o Serviço do Sistema PowerPivot. Você precisa ter pelo menos um aplicativo de serviço PowerPivot no farm e deve ser membro do grupo de proxy padrão.

Observe que esse script usa o pool de aplicativo de serviço padrão como a identidade de serviço para o aplicativo de serviço PowerPivot. Observe também que esse script inclui um espaço reservado para o servidor de banco de dados do farm. Certifique-se de substituir a cadeia de caracteres 'O nome do servidor de banco de dados vai aqui' pelo nome da instância do mecanismo de banco de dados do SQL Server que hospeda o banco de dados de configuração para o farm.

Antes de você executar o script, verifique se o servidor de banco de dados está configurado para permitir conexões de TCP/IP remotas. Você poderá usar a ferramenta de configuração do SQL Server para habilitar TCP/IP se ainda não tiver feito isso.

Uma alternativa para esse script é usar as instruções no tópico a seguir: Criar e configurar um aplicativo de serviço PowerPivot.

New-PowerPivotServiceApplication -ServiceApplicationName "Default PowerPivot Service Application" -DatabaseServerName "your database server name goes here" -DatabaseName DefaultPowerPivotServiceApplicationDB -AddToDefaultProxyGroup

Iniciar as declarações para o Serviço de Token do Windows

As Declarações para o serviço de Token do Windows devem estar em execução em cada servidor do SharePoint que tiver o SharePoint instalado.

Uma alternativa a esse script é usar as instruções no tópico a seguir: Instalar o PowerPivot para SharePoint em um SharePoint Server existente.

  1. Execute o comando a seguir para obter a ID das Declarações para o Serviço de Token do Windows:

    Get-SPServiceInstance

  2. Copie a ID que é retornada para o serviço.

  3. Insira o comando a seguir usando a ID para especificar o serviço.

    Start-SPServiceInstance <ID>

  4. Execute Get-SPServiceInstance novamente para verificar se as Declarações para o Serviço de Token do Windows estão online.

  5. Repita em cada servidor do SharePoint que tiver o PowerPivot para SharePoint instalado.

Habilitar e configurar Serviços do Excel

Os Serviços do Excel realizam a renderização do lado do servidor de pastas de trabalho do Excel que você publica no SharePoint. O PowerPivot para SharePoint depende dos Serviços do Excel para disparar solicitações de dados do PowerPivot e renderizar dados do PowerPivot como Tabelas Dinâmicas ou outros objetos de dados em uma pasta de trabalho.

Uma alternativa a esse script é usar as instruções no tópico a seguir: Instalar o PowerPivot para SharePoint em um SharePoint Server existente.

Obter informações e verificar pré-requisitos

  1. Execute o comando a seguir para verificar se os Serviços de Cálculo do Excel estão online. Se o serviço não estiver online, inicie-o usando a mesma abordagem que você usou para iniciar as Declarações para o Serviço de Token do Windows.

    Get-SPServiceInstance

  2. Execute o comando a seguir para verificar se o aplicativo de serviço dos Serviços do Excel já está habilitado: Se um aplicativo de serviço já existir, ignore os comandos para criá-lo, mas execute os comandos que habilitam o acesso a dados externos, aumente o tamanho máximo das pastas de trabalho e desative os avisos da atualização de dados.

    Get-SPExcelServiceApplication

  3. Obtenha o nome do pool de aplicativos que você usará para criar o aplicativo de serviço. No script seguinte, você usará a ferramenta de aplicativo Padrão dos Serviços Web do SharePoint. Porém, você pode executar o comando a seguir para determinar se outros pools de aplicativos são mais adequados.

    Get-SPServiceApplicationPool

Criar o aplicativo do serviço e o proxy de aplicativo do serviço

New-SPExcelServiceApplication -name "Excel Services Application" –ApplicationPool "SharePoint Web Services Default"
New-SPExcelServiceApplicationProxy -name "Excel Services Application Proxy" –ServiceApplication "Excel Services Application" -DefaultProxyGroup

Configurar o aplicativo de serviço

Esse script aumenta o tamanho máximo da pasta de trabalho, habilita o acesso a dados externos e desativa avisos de atualização.

Set-SPExcelFileLocation -Identity 'http://' -ExcelServiceApplication "Excel Services Application" -ExternalDataAllowed 2 -WorkbookSizeMax 2000 -WarnOnDataRefresh:$false

Adicionar o aplicativo de serviço ao grupo de proxy de aplicativo do serviço padrão

  1. Obtenha a ID do proxy de aplicativo de serviço para o aplicativo Serviços do Excel e copie a ID.

    Get-SPServiceApplicationProxy

  2. Adicione a ID do proxy do aplicativo de serviço ao grupo de proxy padrão, substituindo "serviceAppId" pela ID real que você copiou da janela do PowerShell.

    $ProxyGroup = Get-SPServiceApplicationProxygroup -default
Add-SPServiceApplicationProxyGroupMember -Identity $ProxyGroup -Member "serviceAppId"

Habilitar o Serviço de Repositório Seguro e configurar a atualização de dados

Serviço de Repositório Seguro é um recurso do SharePoint usado para armazenar credenciais. O PowerPivot para SharePoint usa o Serviço de Repositório Seguro para oferecer suporte a operações de atualização de dados baseadas em credenciais referenciadas ou armazenadas.

Observação importanteImportante

Executar os comandos nesta seção é suficiente para habilitar algumas opções de atualização de dados do PowerPivot. Especificamente, as pessoas podem inserir suas próprias credenciais para executar o trabalho de atualização de dados ou digitar a ID SSS de um aplicativo de destino predefinido que fornece as credenciais. Esse script não cria nem define a conta de atualização de dados autônoma do PowerPivot. Você pode desenvolver esse script ou configurar a conta em Administração Central. Para obter mais informações, consulte Configurar e usar credenciais armazenadas para a atualização de dados PowerPivot.

Obter informações e verificar pré-requisitos

Execute o comando a seguir para verificar se o Serviço de Repositório Seguro está online. Se o serviço não estiver online, inicie-o usando a mesma abordagem que você usou para iniciar as Declarações para o Serviço de Token do Windows.

Get-SPServiceInstance

Criar o aplicativo de serviço

Certifique-se de substituir o valor de espaço reservado para o servidor de banco de dados.

New-SPSecureStoreServiceapplication -Name "Secure Store Service" -partitionmode:$false -sharing:$false -databaseserver "Your database server" -databasename "SecureStoreServiceAppDB" -ApplicationPool "SharePoint Web Services Default" -auditingEnabled:$true -auditlogmaxsize 30

Criar o proxy do aplicativo de serviço e adicione-o ao grupo de proxy padrão

  1. Obtenha a ID do aplicativo de serviço para os Serviços de Repositório Seguro e copie a ID.

    Get-SPServiceApplication

  2. Execute o comando a seguir, substituindo a <ID> pela ID do aplicativo de serviço que você copiou na etapa anterior:

    New-SPSecureStoreServiceApplicationProxy -name "Secure Store Service Proxy" -ServiceApplication <ID> -defaultproxygroup

Gerar a chave mestra

  1. Defina uma variável para a chave mestra.

    $newPassPhrase='type a strong password here'

  2. Copie a ID do proxy do aplicativo de Serviço de Repositório Seguro. Você a usará na próxima etapa.

    Get-SPServiceApplicationProxy

  3. Defina uma variável para o proxy de aplicativo de serviço.

    $proxy='paste the ID for the secure store service application proxy here'

  4. Execute os comandos a seguir em ordem sequencial:

    Update-SpSecureStoreMasterKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase
Update-SpSecureStoreApplicationServerKey -ServiceApplicationProxy $proxy -PassPhrase $newPassPhrase

Configurar coleta de dados de integridade e uso

Esse script habilita a coleta de dados de integridade de servidor e uso que coleta informações sobre como o sistema é usado. Ele especifica um intervalo de coleta de dados de 5 minutos, que é mais frequente que o valor padrão de 30 minutos. Habilitar a coleta de dados de uso fornece informações que são usadas em relatórios internos, inclusive no Painel de Gerenciamento do PowerPivot.

Uma alternativa a esse script é usar as instruções no tópico a seguir: Configurar a coleta de dados de uso (PowerPivot para SharePoint).

Set-SPUsageService -UsageLogCutTime 5

Reconfigurar o tamanho de carregamento máximo do aplicativo Web padrão

Por padrão, o SharePoint permite carregar arquivos até 50 megabytes em tamanho. Esse script altera o tamanho de carregamento de arquivo máximo do aplicativo Web do SharePoint para 2047 megabytes. 2047 é o valor máximo compatível com o SharePoint.

Insira cada uma das linhas a seguir em ordem sequencial. A primeira linha obtém o aplicativo web, a segunda linha define a propriedade e a terceira linha atualiza a propriedade no servidor. Certifique-se de substituir o valor de espaço reservado de "somesite" pelo nome real de seu aplicativo. Você pode usar Get-SPWebApplication para retornar uma lista de aplicativos que são definidos em seu farm.

Uma alternativa a esse script é usar as instruções no tópico a seguir: Configurar o tamanho máximo do carregamento de arquivo (PowerPivot para SharePoint).

$webapplication=Get-SPWebApplication http://somesite/
$webapplication.MaximumFileSize=2047
$webapplication.Update()