Add-SPShellAdmin
Adiciona um usuário à função SharePoint_Shell_Access para o banco de dados especificado.
Sintaxe
Default (Padrão)
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 destina-se apenas a ser utilizado com uma base de dados que utiliza autenticação do Windows. Não é necessário utilizar este cmdlet para bases de dados que utilizam a autenticação SQL; Na verdade, fazê-lo pode resultar numa 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 utilizar Windows PowerShell para Produtos SharePoint, um utilizador tem de ser membro da função SharePoint_Shell_Access na base de dados de configuração e membro do grupo local WSS_ADMIN_WPG no computador onde os Produtos SharePoint estão instalados.
No entanto, o resultado da execução deste cmdlet é que o utilizador especificado com o parâmetro UserName terá a função SPDataAccess , se existir, ou db_owner função, se a função SPDataAccess não existir, nas bases de dados afetadas, 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 permissões e as informações mais recentes sobre 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
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gerencia objetos para o devido descarte. 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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-database
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPDatabasePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UserName
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o nome do usuário a ser adicionado à função SharePoint_Shell_Access no banco de dados de destino.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.