Get-EntraUserSponsor
Recuperar patrocinadores de un usuario (usuarios o grupos).
Sintaxis
GetQuery
Get-EntraUserSponsor
-UserId <String>
[-All]
[-Filter <String>]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraUserSponsor
-UserId <String>
-SponsorId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
El Get-EntraUserSponsor cmdlet recupera los patrocinadores de un usuario (usuarios o grupos). La característica patrocinador realiza un seguimiento de quién es responsable de cada usuario invitado mediante la asignación de una persona o grupo, lo que garantiza la responsabilidad.
En escenarios delegados con cuentas profesionales o educativas, el usuario que ha iniciado sesión necesita un rol de Microsoft Entra compatible o un rol personalizado con microsoft.directory/users/sponsors/read permission. Los roles admitidos con privilegios mínimos son:
- Invitador de usuarios
- Lectores de directorios
- Escritores de directorios
- Administrador de usuarios
Ejemplos
Ejemplo 1: Obtener los patrocinadores del usuario
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -All |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
eeeeeeee-4444-5555-6666-ffffffffffff Fabrikam Helpdesk Group #microsoft.graph.group 8/7/2024 2:52:47 PM
En este ejemplo se muestra cómo enumerar patrocinadores de usuarios.
- El
-UserIdparámetro especifica el identificador de usuario o el nombre principal de usuario.
Ejemplo 2: Obtener un patrocinador superior
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -Top 1 |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
En este ejemplo se recupera el patrocinador superior del usuario especificado. Puede usar -Limit como alias para -Top.
- El
-UserIdparámetro especifica el identificador de usuario o el nombre principal de usuario.
Ejemplo 3: Recuperar el patrocinador asignado para un usuario específico por su SponsorId
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -SponsorId 'cccccccc-2222-3333-4444-dddddddddddd' |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
eeeeeeee-4444-5555-6666-ffffffffffff Fabrikam Helpdesk Group #microsoft.graph.group 8/7/2024 2:52:47 PM
En este ejemplo se recupera el patrocinador asignado para el usuario especificado.
- El
-UserIdparámetro especifica el identificador de usuario o el nombre principal de usuario. - El
-SponsorIdparámetro especifica el identificador de patrocinador del usuario específico que se va a recuperar (identificador de usuario o grupo).
Parámetros
-All
Enumera todas las páginas.
Propiedades de parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Filter
Especifica una instrucción de filtro de OData v4.0. Este parámetro controla qué objetos se devuelven.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetQuery
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Property
Especifica las propiedades que se van a devolver.
Propiedades de parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Select |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SponsorId
Especifica el identificador de patrocinador del usuario específico que se va a recuperar (identificador de usuario o grupo).
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Top
Especifica el número máximo de registros que se van a devolver.
Propiedades de parámetro
| Tipo: | System.Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Limit |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-UserId
Especifica el identificador (como UserPrincipalName o UserId) de un usuario en Microsoft Entra ID.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ObjectId (identificador de objeto), UPN, Identity, NombrePrincipalDelUsuario |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| 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 obtener más información, vea about_CommonParameters.