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 -UserId pará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 -UserId pará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 -UserId parámetro especifica el identificador de usuario o el nombre principal de usuario.
  • El -SponsorId pará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.