Get-SPUser
Devuelve las cuentas de usuario que cumplen unos determinados criterios de búsqueda.
Sintaxis
Default (Es el valor predeterminado).
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
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Group
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el grupo de usuarios al que pertenece el nuevo usuario.
Propiedades del parámetro
| Tipo: | SPGroupPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPUserPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | UserAlias |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Limit
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica la cantidad máxima de usuarios que se devuelven. El valor predeterminado es 500.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Web
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPWebPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.