Descrição geral do módulo Microsoft.SharePoint.Powershell

Para obter uma listagem dos cmdlets do SharePoint Server, consulte Cmdlets microsoft.SharePoint.Powershell.

Acessar o Windows PowerShell para SharePoint Server

Depois de instalar o SharePoint Server, os cmdlets do PowerShell aplicáveis estão disponíveis na Shell de Gestão do SharePoint 2016. Pode gerir a maioria dos aspetos do SharePoint Server na Shell de Gestão 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 a Shell de Gestão do SharePoint, não tem de registar o snap-in que contém os cmdlets. O registo é processado pela Add-PSSnapin Microsoft.SharePoint.PowerShell linha no SharePoint.ps1 ficheiro. Este ficheiro está localizado na %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration pasta .

• <version> 15 é igual ao SharePoint Server 2013
• e <version> 16 é igual ao SharePoint Server 2016

Para usar o console do Windows PowerShell, você deve registrar este snap-in manualmente.

Quer utilize a Shell de Gestão do SharePoint ou a consola do PowerShell, também pode carregar snap-ins e módulos 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. A utilização da Shell de Gestão do SharePoint é definida por esta linha, {Host.Runspace.ThreadOptions = "ReuseThread"}, que está no SharePoint.ps1 ficheiro. Para obter mais informações, confira Opções de thread PS.

Permissões

Antes de poder utilizar o Add-SPShellAdmin cmdlet para conceder permissões para os utilizadores executarem cmdlets do SharePoint Server, verifique se cumpre todos os seguintes requisitos mínimos:

• Tem de ter associação na função de servidor fixa SecurityAdmin na instância 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 não tiver associação na função SharePoint_Shell_Access ou WSS_Admin_WPG grupo local, utilize o Add-SPShellAdmin cmdlet para adicionar o grupo de WSS_Admin_WPG em todos os servidores Web front-end no farm do SharePoint e na função de SharePoint_Shell_Access . Se a base de dados SQL Server não tiver uma função de SharePoint_Shell_Access, a função é criada automaticamente quando executa o Add-SPShellAdmin cmdlet. Depois de executar o cmdlet, os Add-SPShellAdmin utilizadores podem executar cmdlets do PowerShell do SharePoint num ambiente de farm de múltiplos 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 não tiverem sido adicionados utilizadores para executar um cmdlet do PowerShell, pode utilizar o Add-SPShellAdmin cmdlet para os adicionar.

Para ver uma lista de todos os cmdlets SPShellAdmin , numa linha de comandos do PowerShell, escreva Get-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 do Microsoft PowerShell têm uma .ps1 extensão de nome de ficheiro.

Para executar scripts, a política de execução mínima necessária para o SharePoint Server é RemoteSigned, embora a política predefinida do PowerShell seja Restrita. Se a política for deixada como Restrita, a Shell de Gestão do SharePoint altera a política do 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. Esta alteração aplica-se a todas as sessões do PowerShell. Para obter mais informações sobre scripts e políticas de execução, veja about_scripts e Acerca das Políticas de Execução.