Cmdlets do SharePoint Server

Para obter uma lista dos cmdlets do SharePoint Server, confira cmdlets do SharePoint Server

Acessar o Windows PowerShell para SharePoint Server

Depois de instalar o SharePoint Server, os cmdlets aplicáveis do PowerShell estarão disponíveis no Shell de Gerenciamento do SharePoint 2016. Você pode gerenciar a maioria dos aspectos do SharePoint Server no Shell de Gerenciamento do SharePoint. Também pode criar novos conjuntos de site, aplicativos Web, contas de usuário, aplicativos de serviço, proxies e mais. Os comandos que você digita no SharePoint Management Shell retornam objetos do SharePoint baseados no Microsoft .NET Framework. E pode aplicar esses objetos como entrada a comandos subsequentes ou pode armazenar os objetos em variáveis locais para uso posterior.

Com o Shell de Gerenciamento do Microsoft Office SharePoint Online, 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 Server é automático, como resultado do Microsoft Add-PSSnapin. A linha SharePoint.PowerShell no arquivo SharePoint.ps1 localizada em %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration, em que a versão "15" é igual ao SharePoint Server 2013 e a versão "16" é igual ao SharePoint Server 2016. Para usar o console do Windows PowerShell, você deve registrar este snap-in manualmente.

Quer você use o Shell de Gerenciamento do Microsoft Office SharePoint Online ou o console do Windows PowerShell, você também pode carregar snap-ins adicionais.

Observação

O Shell de Gerenciamento do Microsoft Office SharePoint Online e o console do Windows PowerShell também diferem no uso da opção ReuseThread, que define como o modelo de threading é usado. O uso do Shell de Gerenciamento do Microsoft Office SharePoint Online é definido por esta linha, {Host.Runspace.ThreadOptions = "ReuseThread"}, que está no arquivo SharePoint.ps1. Para obter mais informações, confira Opções de thread PS.

Permissões

Antes que você possa usar o cmdlet do Add-SPShellAdmin para conceder permissões a usuários para executar cmdlets do SharePoint Server, verifique se você atende a todos os requisitos mínimos a seguir:

  • Você deve ser membro da função de servidor fixa securityadmin na instância do SQL Server.
  • Você deve ser um membro do grupo de Administradores no servidor no qual você está executando o cmdlet PowerShell.

Observação

Se as permissões não forem satisfeitas, entre em contato com seu Administrador da instalação ou com o administrador do SQL Server para solicitar essas permissões.

Para mais informações sobre as permissões do Windows PowerShell, consulte Add-SPShellAdmin.

Se você não for membro da função SharePoint_Shell_Access ou do grupo local WSS_Admin_WPG, use o cmdlet Add-SPShellAdmin para adicionar o grupo WSS_Admin_WPG em todos os servidores Web front-end no farm do SharePoint farm e na função SharePoint_Shell_Access. Se o banco de dados do SQL Server não tem a função SharePoint_Shell_Access, ela é automaticamente criada ao executar o cmdlet Add-SPShellAdmin. Depois de executar o cmdlet Add-SPShellAdmin, os usuários podem executar os cmdlets do SharePoint PowerShell em um ambiente de farm de vários servidores.

Observação

Ao instalar o SharePoint Server, a conta de usuário da qual você executa a instalação obtém as permissões apropriadas para executar os cmdlets PowerShell. Se nenhum usuário tiver sido adicionado para executar o cmdlet PowerShell, você pode usar o cmdlet Add-SPShellAdmin para adicioná-los.

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

Scripts e política de execução

Embora você possa usar o Microsoft PowerShell para realizar uma tarefa administrativa única, você também pode usar um script para automatizar uma série de tarefas. Um script é um arquivo de texto que contém um ou mais comandos Microsoft PowerShell. Os scripts Microsoft PowerShell têm uma extensão de arquivo chamada .ps1.

Para executar scripts, a política de execução mínima necessária para o SharePoint Server é RemoteSigned, embora a política padrão para Windows PowerShell seja restrita. Se a política for deixada como Restrita, o Shell de Gerenciamento do Microsoft Office SharePoint Online alterará a política do Windows PowerShell para RemoteSigned. Isso significa que você deve selecionar Executar como administrador para iniciar o Shell de Gerenciamento do Microsoft Office SharePoint Online com permissão administrativa elevada. Essa alteração se aplicará a todas as sessões do Windows PowerShell. Para obter mais informações, confira ExecutionPolicy Enumeration.

Para obter informações adicionais sobre scripts e políticas de execução, confira about_scripts e Sobre políticas de execução.