Remove-SPUser

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Remove um usuário de um site.

Syntax

Remove-SPUser
      [-Identity] <SPUserPipeBind>
      -Web <SPWebPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Group <SPGroupPipeBind>]
      [-WhatIf]
      [<CommonParameters>]

Description

O Remove-SPUser cmdlet especifica a identidade e o grupo de usuários do qual um usuário deve ser removido. O Remove-SPUser cmdlet não remove o usuário do Active Directory Domain Services (AD DS).

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

Remove-SPUser "Contoso\jdoe" -web https://test/web1

Get-SPWeb "https://test/web1" | Remove-SPUser "Contoso\jdoe"

Este exemplo remove o usuário (Contoso\jdoe) do aplicativo Web https://test/web1.

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

Get-SPSite https://contoso.com |Get-SPWeb |Remove-SPUser "Contoso\jdoe"

Esta sintaxe remove o usuário (Contoso\Jdoe) de toda a Web em um conjunto de sites localizado em https://contoso.com.

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

-Group

O usuário é removido apenas desse grupo. Caso contrário, ele é removido do site.

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

-Identity

Especifica o GUID, o nome de usuário ou o objeto SPUser a ser removido.

O tipo deve ser um GUID válido do usuário, no formato 1234-5678-9876-0987.

Type:	SPUserPipeBind
Aliases:	UserAlias
Position:	1
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

-Web

Especifica o nome da URL ou do GUID do qual o usuário deve ser removido. Esse parâmetro será necessário somente se a identidade fornecida for o nome de usuário.

O tipo deve ser uma URL válida, no formato https://server_name; ou um GUID, no formato 1234-5678-9807.

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

Compartilhar via