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