Set-EntraBetaUserSponsor

Módulo:
Microsoft.Entra.Beta.Users Module v1.3

Establece los patrocinadores de un usuario (usuarios o grupos).

Sintaxis

SetUserSponsor (valor predeterminado) 

Set-EntraBetaUserSponsor

    -UserId <String>
    -Type <String>
    -SponsorIds <String[]>
    [<CommonParameters>]

Description

El Set-EntraBetaUserSponsor cmdlet establece 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.

Update-EntraBetaUserSponsor es un alias de Set-EntraBetaUserSponsor.

En escenarios delegados con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado que incluya el microsoft.directory/users/sponsors/update permiso.

Los siguientes roles con privilegios mínimos admiten esta operación:

  • Escritores de directorios
  • Administrador de usuarios

Ejemplos

Ejemplo 1: Asignación de un patrocinador de usuario único

Connect-Entra -Scopes 'User.ReadWrite.All'
$sponsor = Get-EntraBetaUser -UserId 'SponsorEmail@contoso.com'
Set-EntraBetaUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type User -SponsorIds $sponsor.Id

En este ejemplo se muestra cómo asignar un solo usuario como patrocinador a una cuenta de usuario de destino.

  • El -UserId parámetro especifica el identificador de usuario o el nombre principal de usuario. Puede usar -UserPrincipalName, -Identity, -UPN, -ObjectId como alias para -UserId.
  • El -Type parámetro especifica el tipo de patrocinador que se asigna al usuario. Los tipos de patrocinador admitidos son (usuario o grupo).
  • El -SponsorIds parámetro especifica los identificadores de patrocinadores que se asignarán al usuario.

Ejemplo 2: Asignación de un patrocinador de grupo único

Connect-Entra -Scopes 'User.ReadWrite.All', 'GroupMember.Read.All'
$group = Get-EntraBetaGroup -SearchString 'Sales and Marketing'
Set-EntraBetaUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type Group -SponsorIds $group.Id

En este ejemplo se muestra cómo asignar un único grupo como patrocinador a una cuenta de usuario de destino.

  • El -UserId parámetro especifica el identificador de usuario o el nombre principal de usuario. Puede usar -UserPrincipalName, -Identity, -UPN, -ObjectId como alias para -UserId.
  • El -Type parámetro especifica el tipo de patrocinador que se asigna al usuario. Los tipos de patrocinador admitidos son (usuario o grupo).
  • El -SponsorIds parámetro especifica los identificadores de patrocinadores que se asignarán al usuario.

Ejemplo 3: Asignación de varios patrocinadores de usuario

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type User -SponsorIds @("db0c6l50-93ee-4b22-9bb9-c8454875d990","c9db38b9-e5b8-4b5e-ak78-9812230af58d")

En este ejemplo se muestra cómo asignar varios usuarios como patrocinadores a una cuenta de usuario de destino.

  • El -UserId parámetro especifica el identificador de usuario o el nombre principal de usuario. Puede usar -UserPrincipalName, -Identity, -UPN, -ObjectId como alias para -UserId.
  • El -Type parámetro especifica el tipo de patrocinador que se asigna al usuario. Los tipos de patrocinador admitidos son (usuario o grupo).
  • El -SponsorIds parámetro especifica los identificadores de patrocinadores que se asignarán al usuario.

Ejemplo 4: Asignación de varios patrocinadores de grupos

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type Group -SponsorIds @("db0c6f50-93ee-4b22-9bb9-c8454875d990","c9db38b9-e5v8-4b5e-ae78-9812230af58d")

En este ejemplo se muestra cómo asignar varios grupos como patrocinadores a una cuenta de usuario de destino.

  • El -UserId parámetro especifica el identificador de usuario o el nombre principal de usuario. Puede usar -UserPrincipalName, -Identity, -UPN, -ObjectId como alias para -UserId.
  • El -Type parámetro especifica el tipo de patrocinador que se asigna al usuario. Los tipos de patrocinador admitidos son (usuario o grupo).
  • El -SponsorIds parámetro especifica los identificadores de patrocinadores que se asignarán al usuario.

Parámetros

-SponsorId

Especifica el identificador de patrocinador (id. de usuario o grupo) que se va a asignar al destino de usuario específico.

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

-Type

Especifica el tipo de patrocinadores que se asigna al usuario. Los tipos de patrocinador admitidos son (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

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