New-SPUser
Adiciona um usuário existente a um site do SharePoint com as permissões designadas.
Syntax
New-SPUser
[-UserAlias] <String>
-Web <SPWebPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-DisplayName <String>]
[-Email <String>]
[-Group <SPGroupPipeBind>]
[-PermissionLevel <String[]>]
[-SiteCollectionAdmin]
[-WhatIf]
[<CommonParameters>]
Description
O New-SPUser
cmdlet adiciona um usuário existente a um site do SharePoint com as permissões designadas.
Esse usuário tem as permissões determinadas em todos os subsites que herdam permissões.
A conta de usuário já deve existir no diretório de usuário.
Se seu ambiente estiver no modo do Active Directory, o usuário já deverá existir no AD DS (Serviços de Domínio Active Directory) e somente o parâmetro UserAlias será obrigatório; todos os outros campos serão retirados do AD DS. Se apenas um alias for fornecido e o farm estiver no modo Criação de Conta do Active Directory, o parâmetro Email também será obrigatório.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
------------------EXEMPLO 1----------------------
New-SPUser -UserAlias 'Contoso\Jdow'-DisplayName 'Jane Dow' -Web https://contoso.com
Este exemplo adiciona um novo usuário denominado Jane Dow ao domínio Contoso.
------------------EXEMPLO 2----------------------
Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow
Este exemplo adiciona Contoso\Jdow a todas as Webs da coleção de https://sitename sites. Como este conjunto de sites usa permissões herdadas, apenas o site de nível superior precisa ser tocado.
Parâmetros
-AssignmentCollection
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.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment
, pode ocorrer um cenário de memória insuficiente.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DisplayName
Especifica uma cadeia de caracteres que contém o nome para exibição do usuário
O tipo deve ser um nome de usuário válido, por exemplo, Joe.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
Especifica o endereço de email do novo usuário.
O tipo deve ser um endereço de email válido, no formulário someone@contoso.com.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Group
Especifica o grupo de usuário ao qual o novo usuário pertence.
Type: | SPGroupPipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-PermissionLevel
Adiciona um usuário a um nível de permissão.
O tipo deve ser um nível de permissão válido para o aplicativo Web; por exemplo, Full Control, Read, Contribute ou All.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SiteCollectionAdmin
Especifica se você irá adicionar o usuário como administrador ao conjunto de sites.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UserAlias
Especifica o alias do usuário dos Serviços de Domínio do Active Directory (AD DS).
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Web
Especifica a URL ou o GUID da Web no qual criar este usuário.
O tipo deve ser uma URL válida, no formato https://server_name; ou um GUID, no formato 1234-5678-9876-0987.
Type: | SPWebPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |