Administração dos Produtos do SharePoint 2010 usando o Windows PowerShell

 

Aplica-se a: SharePoint Foundation 2010

Tópico modificado em: 2017-01-18

Este artigo descreve como usar o Windows PowerShell com os Produtos do Microsoft SharePoint 2010 e fornece uma visão geral de cmdlets e conceitos básicos do Windows PowerShell necessários para obter o máximo benefício desse poderoso recurso.

Neste artigo:

  • Visão geral

  • Acessando o Windows PowerShell para Produtos do SharePoint 2010

  • Permissões

  • Aprendendo a usar o Windows PowerShell

Visão geral

O Windows PowerShell é uma ferramenta de script de linha de comando que fornece ao administrador acesso total a APIs (interfaces de programação de aplicativo) aplicáveis, bem como a capacidade de desbloquear o recurso de interação direta com os Produtos do SharePoint 2010 para manipular aplicativos Web, conjuntos de sites, sites, listas e muito mais. Além disso, o administrador tem a capacidade de criar scripts de cmdlets (pronuncia-se “command-lets”), que contribuem para melhorar a experiência em relação às versões anteriores do produto.

O Windows PowerShell 2,0 é um pré-requisito para a instalação dos Produtos do SharePoint 2010. Ele será instalado, se necessário, quando você executar a Ferramenta de Preparação de Produtos do Microsoft SharePoint. Por padrão, o Windows PowerShell está localizado no seguinte caminho: <%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe.

Observação

O Windows PowerShell 2,0 é compatível com versões anteriores do Windows PowerShell 1.0 e instalações posteriores na pasta v1.0.

Para obter uma lista de novos recursos do Windows PowerShell versão 2.0, consulte o artigo sobre o Windows PowerShell 2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0x416).

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.

Acessando o Windows PowerShell para Produtos do SharePoint 2010

Após a instalação dos Produtos do SharePoint 2010, os cmdlets aplicáveis do Windows PowerShell estão disponíveis por meio do Shell de Gerenciamento do SharePoint 2010 ou do console do Windows PowerShell. Com o shell de gerenciamento, você pode gerenciar todos os aspectos dos Produtos do SharePoint 2010. É possível criar novos conjuntos de sites, aplicativos Web, contas de usuário, aplicativos de serviço, proxies e muito mais. Os comandos do Shell de Gerenciamento geram objetos do SharePoint com base na Plataforma Microsoft .NET. Esses objetos podem ser aplicados como entrada para comandos subsequentes ou armazenados em variáveis locais para uso posterior.

Com o shell de gerenciamento, você não precisa registrar o snap-in que contém os cmdlets. O registro do módulo Microsoft.SharePoint.PowerShell.dll para cmdlets do SharePoint 2010 é automático, como resultado da linha Add-PSSnapin Microsoft.SharePoint.PowerShell no arquivo SharePoint.ps1, localizado em %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration. Se optar por usar o console do Windows PowerShell, você deverá registrar o snap-in manualmente.

Quer esteja usando o shell de gerenciamento ou o console do Windows PowerShell, você também poderá carregar snap-ins adicionais. Para obter mais informações, consulte o artigo sobre personalização de perfis (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0x416).

Para acessar o Shell de Gerenciamento do SharePoint 2010

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

  2. Clique em Produtos do Microsoft SharePoint 2010.

  3. Clique em Shell de Gerenciamento do SharePoint 2010.

Observação

O Shell de Gerenciamento do SharePoint 2010 e o console do Windows PowerShell também diferem quanto ao uso da opção ReuseThread, que define como o modelo de threading é usado. O uso do shell de gerenciamento é definido por esta linha, {Host.Runspace.ThreadOptions = "ReuseThread"}, que está no arquivo SharePoint.ps1. Para obter mais informações, consulte o artigo sobre opções de thread do PS (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0x416).

Permissões

Para poder usar o shell de gerenciamento e os cmdlets do Windows PowerShell, verifique se os seguintes requisitos mínimos foram atendidos: Consulte Add-SPShellAdmin.

Se você não dispõe de associação à função SharePoint_Shell_Access ou ao grupo local WSS_Admin_WPG, use o cmdlet Add-SPShellAdmin. Quando o cmdlet Add-SPShellAdmin é usado, o usuário é adicionado ao grupo WSS_Admin_WPG em todos os servidores Web front-end, além de ser adicionado à função SharePoint_Shell_Access. Se o banco de dados de destino não tiver uma função SharePoint_Shell_Access, ela será criada automaticamente. Após a execução do cmdlet Add-SPShellAdmin, o usuário pode executar os cmdlets do Windows PowerShell do SharePoint 2010 em um ambiente de farm com vários servidores.

Ao executar o cmdlet Add-SPShellAdmin para adicionar um usuário à função SharePoint_Shell_Access, você deve ter as seguintes permissões de segurança:

  • Acesso à função de servidor Securityadmin na instância do SQL e à função db_owner em um banco de dados.

  • Permissão administrativa para o computador local.

Observação

Geralmente, a pessoa que usará o cmdlet Add-SPShellAdmin deve estar associada à conta de usuário que foi usada para a Instalação.

Você deverá executar o cmdlet Add-SPShellAdmin para todos os bancos de dados para os quais desejar conceder acesso. Se nenhum banco de dados for especificado, será usado o de configuração do farm. Se você fizer uma especificação, o banco de dados de conteúdo do farm será incluído, além do banco de dados de configuração do farm especificado.

Para ver a lista de todos os cmdlets *SPShellAdmin, em um prompt de comando do Windows PowerShell, digite Get-Command -Noun SPShellAdmin.

Aprendendo a usar o Windows PowerShell

Há vários recursos de aprendizagem para profissionais de TI do SharePoint que não estão familiarizados com o Windows PowerShell.

TechNet Scripting Center

O TechNet Scripting Center inclui muitos recursos para aprender noções básicas do uso do Windows PowerShell. Além disso, contém repositórios de scripts com exemplos dos scripts normalmente usados com vários produtos da Microsoft. A tabela a seguir mostra os principais recursos de aprendizagem.

Página Descrição

Documentação do Windows PowerShell no TechNet (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0x416)

Essa seção da TechNet Library contém cópias da Web dos principais tópicos de obtenção de ajuda do Windows PowerShell. A seção também fornece cópias da Web do documento Guia de Introdução, da ajuda do arquivo PowerShell.exe e de um manual do Windows PowerShell.

Script com Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0x416)

A home page de recursos de aprendizagem sobre scripts do Windows PowerShell.

Manual do proprietário do Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0x416)

Guia baseado na Web de introdução ao Windows PowerShell.

Referência rápida do Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0x416)

Cópia baixável do documento de referência rápida instalado com o Windows PowerShell.

Documentos do Windows PowerShell

O Windows PowerShell instala os documentos a seguir no grupo de programas do Windows PowerShell 1.0. Eles também podem ser instalados após o download do Windows PowerShell 1.0 Documentation Pack (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0x416).

Arquivo Descrição

GettingStarted.rtf

Descreve como começar a usar o Windows PowerShell.

UsersGuide.rtf

Um manual sobre o ambiente e a linguagem do Windows PowerShell.

QuadFold.rtf

Um documento de referência rápida imprimível sobre a sintaxe e comandos comumente usados do Windows PowerShell. Também disponível para download no TechNet Scripting Center.

Ao ler esses recursos, leve em consideração que é útil aprender sobre os conceitos e cmdlets a seguir antes de usar o Windows PowerShell para Produtos do SharePoint 2010: