Add-SPShellAdmin

Adiciona um usuário à função SharePoint_Shell_Access para o banco de dados especificado.

Syntax

Add-SPShellAdmin
   [-UserName] <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-database <SPDatabasePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Ao executar este cmdlet para adicionar um usuário para a função SharePoint_Shell_Access, você deve ter uma assinatura na função do servidor fixo do securityadmin na instância do SQL Server, assinatura na função do banco de dados fixo do db_owner em todos os bancos de dados afetados e permissão administrativa local no computador local.

Este cmdlet é destinado apenas para ser usado com um banco de dados que usa a autenticação do Windows. Não há necessidade de usar este cmdlet para bancos de dados que usam a autenticação SQL. De fato, fazer isso pode resultar em uma mensagem de erro.

Use o cmdlet Add-SPShellAdmin para adicionar um usuário à função SharePoint_Shell_Access, como a seguir:

--Se você especificar apenas o usuário, o usuário é adicionado à função para o banco de dados de configuração do farm.

--Se você usar o parâmetro database, o usuário é adicionado à função no banco de dados de configuração do farm, o banco de dados de conteúdo da Administração central e o banco de dados especificado. Usar o parâmetro database é o método preferido porque a maioria das operações administrativas exigem acesso ao banco de dados de conteúdo da Administração Central.

O usuário é adicionado ao grupo WSS_Admin_WPG em todos os servidores Web quando o usuário é adicionado à função SharePoint_Shell_Access. Se o banco de dados de destino não possui uma função SharePoint_Shell_Access, a função é criada automaticamente.

Para usar o Windows PowerShell para produtos SharePoint, um usuário deve ser membro da função SharePoint_Shell_Access no banco de dados de configuração e membro do grupo local do WSS_ADMIN_WPG no computador onde o SharePoint Products está instalado.

No entanto, o resultado da execução desse cmdlet é que o usuário especificado com o parâmetro UserName terá a função SPDataAccess, se existir, ou uma função db_owner, se a função SPDataAccess não existir, nos bancos de dados afetados conforme descrito acima. Portanto, você deve planejar cuidadosamente quais usuários recebem esse acesso.

Portanto, você deve planejar cuidadosamente quais usuários recebem esse acesso.

Para obter as permissões e informações mais atuais sobre o Windows PowerShell para Produtos SharePoint, consulte a documentação online em https://go.microsoft.com/fwlink/p/?LinkId=251831.

Exemplos

--------------------EXEMPLO 1-----------------------

Add-SPShellAdmin -UserName CONTOSO\User1

Este exemplo adiciona um novo usuário denominado User1 à função SharePoint_Shell_Access somente no banco de dados de configuração do farm e também garante que o usuário seja adicionado ao grupo local WSS_Admin_WPG em cada servidor do farm.

--------------------EXEMPLO 2-----------------------

Add-SPShellAdmin -UserName CONTOSO\User1 -database 4251d855-3c15-4501-8dd1-98f960359fa6

Este exemplo adiciona um novo usuário denominado User1 à função SharePoint_Shell_Access no banco de dados de conteúdo especificado e no banco de dados de configuração ao passar um GUID do banco de dados para o cmdlet.

-------------------EXEMPLO 3-------------------------

Get-SPDatabase | Where-Object {$_.WebApplication -like "SPAdministrationWebApplication"} | Add-SPShellAdmin CONTOSO\User1

Este exemplo adiciona um novo usuário denominado User1 à função SharePoint_Shell_Access no banco de dados de conteúdo da Administração Central especificado e no banco de dados de configuração.

-------------------EXEMPLO 4-------------------------

Get-SPDatabase | ?{$_.Name -eq "WSS_Content"} | Add-SPShellAdmin -Username CONTOSO\User1

Este exemplo adiciona um novo usuário denominado User1 à função SharePoint_Shell_Access no banco de dados de conteúdo especificado e no banco de dados de configuração ao passar o nome do banco de dados para o cmdlet.

Parâmetros

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Confirm

Solicita a sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-database

Especifica o GUID do banco de dados ou o objeto do banco de dados que inclui a função SharePoint_Shell_Access para a qual você deseja adicionar o usuário. Se o parâmetro database não for especificado, o banco de dados de configuração será usado. O banco de dados de configuração do farm sempre será incluído, mesmo se você especificar outro banco de dados.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-UserName

Especifica o nome do usuário a ser adicionado à função SharePoint_Shell_Access no banco de dados de destino.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019