Gerenciar os Serviços do Excel com o Windows PowerShell

Aplica-se a: Excel Services (SharePoint 2010), SharePoint Server 2010

Tópico modificado em: 2010-07-26

Este tópico oferece uma visão geral de alto nível do comportamento do Windows PowerShell para os Serviços do Excel no Microsoft SharePoint Server 2010. Os administradores dos Serviços do Excel podem usar o Windows PowerShell para criar scripts completos de configuração e implantação e opções de configuração dos Serviços do Excel e definir todas as configurações em tempo de execução como parte de implantações do Microsoft SharePoint Server 2010. O Windows PowerShell nos Serviços do Excel segue as mesmas diretrizes de convenções de nomenclatura, estilo e comportamento encontradas em outros aplicativos de serviço. O SharePoint Server oferece a linha de comando do Windows PowerShell para a execução de ações administrativas para os Serviços do Excel.

Windows PowerShell para Serviços do Excel

O usuário deve ser membro da função de administrador global e também um administrador local para executar qualquer comando (cmdlet) do Windows PowerShell em um computador. Normalmente, todos os cmdlets do Windows PowerShell controlam objetos em memória e os cmdlets Set gravam valores de propriedade no repositório de dados configdb data para o serviço.

Os cmdlets dos Serviços do Excel, Windows PowerShell dão suporte aos comandos gerais do Windows PowerShell. Os administradores podem redirecionar os comandos, obter ajuda sobre cada um deles, usar aliases para comandos, filtrar os resultados, permitir o uso do parâmetro whatif e confirmar, além de usar variáveis e parâmetros com os comandos. Para obter mais informações sobre comandos do Windows PowerShell, consulte Cmdlets de Serviços do Excel (SharePoint Server 2010).

Cmdlets de exemplo para os Serviços do Excel

Esta seção mostra como abrir o Shell de Gerenciamento do SharePoint 2010 para executar qualquer um dos cmdlets de exemplo dos Serviços do Excel para os Serviços do Excel.

Para abrir o Shell de Gerenciamento do SharePoint 2010

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 (PS C:\>), digite qualquer um dos seguintes comandos de exemplo a seguir e pressione ENTER:

• Provisionamento de um novo Aplicativo de Serviços do Excel com o nome “MyExcelServer”
  New-SPExcelServiceApplication -Name "MyExcelServer"

• Alteração do número máximo de sessões por usuário para 100 para todos os computadores remotos deste farm que estejam executando uma instância dos Serviços do Excel:
  Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -SessionsPerUserMax 100

• Para MyExcelServer, obter todos os locais confiáveis e, para aqueles que permitem o carregamento de dados de pastas de trabalho, impor o uso exclusivo de DCL (Document Connection Library)
  Get-SPExcelServiceApplication -Identity "MyExcelServer" | Get-SPExcelFileLocation | where {$_.ExternalDataAllowed -eq "DclAndEmbedded" } | Set-SPExcelFileLocation -ExternalDataAllowed Dcl

• Para permitir que pastas de trabalho em locais de arquivo confiáveis (e conexões de dados em bibliotecas de conexão de dados confiáveis) sejam acessadas entre domínios por Web Parts, páginas da Web ou serviços Web, execute o cmdlet Windows PowerShell. Os exemplos de comando a seguir funcionam para todos aplicativos de Serviço do Excel em seu farm do SharePoint Server:
  Para definir como verdadeiro:
  Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed
  Para definir como falso:
  Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed:$false
  Para verificar:
  (Get-SPExcelServiceApplication).CrossDomainAccessAllowed