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 cmdlet especifica a identidade e o grupo de Remove-SPUser usuários do qual um usuário deve ser removido. O cmdlet não remove o usuário dos Serviços de Domínio do Remove-SPUser Active Directory (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 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

-Grupo

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

Type:	SPGroupPipeBind
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

-Identidade

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