Remove-SPUser
Quita un usuario de un sitio web.
Syntax
Remove-SPUser
[-Identity] <SPUserPipeBind>
-Web <SPWebPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Group <SPGroupPipeBind>]
[-WhatIf]
[<CommonParameters>]
Description
El Remove-SPUser
cmdlet especifica la identidad y el grupo de usuarios del que se va a quitar un usuario.
El Remove-SPUser
cmdlet no quita el usuario de Servicios de dominio de Active Directory (AD DS).
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
------------------EJEMPLO 1-----------------------
Remove-SPUser "Contoso\jdoe" -web https://test/web1
Get-SPWeb "https://test/web1" | Remove-SPUser "Contoso\jdoe"
En este ejemplo se quita el usuario (Contoso\jdoe) de la aplicación web. https://test/web1.
------------------EJEMPLO 2-----------------------
Get-SPSite https://contoso.com |Get-SPWeb |Remove-SPUser "Contoso\jdoe"
Esta sintaxis quita el usuario (Contoso\Jdoe) de cada sitio web en una colección de sitios ubicada en https://contoso.com.
Parámetros
-AssignmentCollection
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global.
Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment
, puede producirse un error de memoria 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
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente 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
El usuario solo se quita de ese grupo. De lo contrario, el usuario se quita del sitio.
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 el GUID, el nombre de usuario o el objeto SPUser que se va a quitar.
El tipo debe ser un GUID válido del usuario, con el 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 el nombre de la dirección URL o el GUID de donde se va a quitar el usuario. Este parámetro es necesario solo si la identidad proporcionada es el nombre de usuario.
El tipo debe ser una dirección URL válida, con el formato https://server_name o un GUID, con el 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
Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.
Para obtener más información, escriba el siguiente 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 |