Set-SPUser

Referencia

Módulo:: SharePointServer

Se aplica a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Configura propiedades de un usuario existente.

Syntax

Set-SPUser
   [-Identity] <SPUserPipeBind>
   [-AddPermissionLevel <String[]>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ClearPermissions]
   [-Confirm]
   [-DisplayName <String>]
   [-Email <String>]
   [-Group <SPGroupPipeBind>]
   [-IsSiteCollectionAdmin]
   [-PassThru]
   [-RemovePermissionLevel <String[]>]
   [-SyncFromAD]
   [-Web <SPWebPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

El Set-SPUser cmdlet configura las propiedades de un usuario existente.

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

Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -AddPermissionLevel "Contributor"

En este ejemplo se establece que un usuario (Contoso\jdoe) sea un colaborador en https://intranet.contoso.com.

------------------EJEMPLO 2-----------------------

Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -SyncFromAD

Esto actualiza la lista de información de usuario del usuario "contoso\jdoe" con los valores actuales displayName y mail de atributo de la cuenta de Active Directory del usuario.

Parámetros

-AddPermissionLevel

Especifica el nivel de permiso que se va a agregar al usuario.

El valor debe ser una de las opciones siguientes:

--Contribuir

Puede ver, agregar, actualizar y eliminar elementos y documentos de lista.

--Diseño

Puede ver, agregar, actualizar, eliminar, aprobar y personalizar documentos.

--Control total

Tiene control total para todos los documentos.

--Limited Access

Puede ver listas específicas, bibliotecas de documentos, elementos de lista, carpetas o documentos cuando se conceden permisos.

--Leer

Puede ver páginas y elementos de lista y descargar documentos.

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

-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

-ClearPermissions

Borra todos los permisos asignados del usuario. Si existen los valores Clear y Add, primero se borran los permisos y, a continuación, se agregan nuevos permisos.

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

-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

-DisplayName

Especifica el nuevo nombre para mostrar del usuario.

El tipo debe ser un nombre válido.

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

-Email

Especifica la nueva dirección de correo electrónico del usuario.

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

Agrega el usuario a un grupo existente del sitio determinado.

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 inicio de sesión o el objeto SPUser del usuario que se va a devolver.

El tipo debe ser un GUID de un usuario existente en el formulario, 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

-IsSiteCollectionAdmin

Especifica si se va a establecer al usuario como administrador de la colección de sitios.

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

-PassThru

Si no se proporciona, indica que este cmdlet no produce resultados. Si se proporciona, este parámetro indica que el objeto SPUser de este usuario se va a devolver.

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

-RemovePermissionLevel

Elimina el nivel de permiso del usuario.

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

-SyncFromAD

Si se proporciona, especifica que la información del usuario se sincronizará desde el almacén de directorios del usuario. Este modificador solo recupera el displayName valor y mail del almacén de directorios. Admite Active Directory (clásico o autenticación de Windows), autenticación basada en formularios y SAML. Los proveedores de FBA y SAML deben admitir la resolución desde su almacén de directorios para que este cambio funcione. El modificador solo admite objetos User de SharePoint.

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

-Web

Especifica el nombre de la dirección URL o el GUID que se van a usar como ámbito. Este parámetro no es necesario si el objeto SPUser se proporciona como identidad.

El valor debe ser una dirección URL auténtica, con el formato https://server_name, o GUID, con el formato 1234-5678-9807.

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

-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