Get-SPUser

Referencia

Módulo:: sharepoint-server

Se aplica a:: SharePoint Server Subscription Edition

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

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

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

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

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