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 ficam 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. É possível também criar novos conjuntos de sites, aplicativos Web, contas de usuário, aplicativos de serviço, proxies e muito mais. Os comandos que você digita no Shell de Gerenciamento do SharePoint retornam objetos do SharePoint baseados no Microsoft .NET Framework. Aplique esses objetos como entradas para comandos posteriores ou armazene-os em variáveis locais para usá-los mais tarde.

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 da linha Add-PSSnapin Microsoft.SharePoint.PowerShell no arquivo SharePoint.ps1 localizado em%CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration, onde 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.