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.

This cmdlet is intended only to be used with a database that uses Windows authentication. There is no need to use this cmdlet for databases that use SQL authentication; in fact, doing so may result in an error message.

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.

--If you use the database parameter, the user is added to the role on the farm configuration database, the Central Administration content database, and the specified database. Using the database parameter is the preferred method because most of the administrative operations require access to the Central Administration content database.

The user is added to the WSS_Admin_WPG group on all Web servers when the user is added to the SharePoint_Shell_Access role. If the target database does not have a SharePoint_Shell_Access role, the role is automatically created.

Para usar o Windows PowerShell para Produtos do 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 em que os Produtos do SharePoint estão instalados.

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 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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, 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 Subscription Edition

-Database

Specifies the GUID of the database or the Database object that includes the SharePoint_Shell_Access role to which you want to add the user. If the database parameter is not specified, the configuration database is used. The farm configuration database is always included, even if you specify another database.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: 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 Subscription Edition