Compartir a través de


Get-SPUser

Devuelve las cuentas de usuario que cumplen unos determinados criterios de búsqueda.

Syntax

Get-SPUser
   [[-Identity] <SPUserPipeBind>]
   -Web <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Group <SPGroupPipeBind>]
   [-Limit <String>]
   [<CommonParameters>]

Description

El cmdlet Get-SPUser devuelve todas las cuentas de usuario de SharePoint que coinciden con el ámbito especificado por los parámetros Identity, Web o Group.

El parámetro Identity puede usar el alias de un usuario para devolver coincidencias exactas.

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

Get-SPUser -Web 'https://sharepoint.contoso.com' -Group 'Viewers'

En este ejemplo se devuelven todos los miembros de los visores del grupo de SharePoint en el sitio https://sharepoint.contoso.com.

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

Get-SPUser -Identity 'i:0#.w|contoso\jdoe' -Web 'https://sharepoint.contoso.com'

En este ejemplo se devuelve el usuario específico identificado mediante notificaciones de Windows en el sitio https://sharepoint.contoso.com.

------------------EJEMPLO 3------------------

Get-SPUser -Identity 'contoso\jdoe' -Web 'https://sharepoint.contoso.com'

En este ejemplo se devuelve el usuario específico identificado mediante la autenticación de Windows clásica en el sitio https://sharepoint.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

-Group

Especifica el grupo de usuarios al que pertenece el nuevo usuario.

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

El tipo debe ser un identificador o un nombre de inicio de sesión válidos, como el formato de "CONTOSO\jdoe" para la autenticación clásica de Windows o "i:0#.w| CONTOSO\jdoe' para notificaciones de Windows.

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

-Limit

Especifica la cantidad máxima de usuarios que se devuelven. El valor predeterminado es 500.

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

-Web

Especifica el sitio web que se va a usar como ámbito.

El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de un sitio web de SharePoint Foundation (por ejemplo, MySPSite1); o una instancia de un objeto SPWeb válido.

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