Set-EntraBetaUserSponsor

Set-EntraBetaUserSponsor

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

O Set-EntraBetaUserSponsor cmdlet define os patrocinadores do utilizador (utilizadores ou grupos). A funcionalidade de patrocinador acompanha quem é responsável por cada utilizador convidado, atribuindo uma pessoa ou grupo, garantindo a responsabilização.

Update-EntraBetaUserSponsor é um alias para Set-EntraBetaUserSponsor.

Em cenários delegados com contas de trabalho ou escola, o utilizador iniciado deve ter uma função Microsoft Entra suportada ou uma função personalizada que inclua a microsoft.directory/users/sponsors/update permissão.

Os seguintes papéis de menor privilégio apoiam esta operação:

• Escritores de Diretórios
• Administrador de usuários

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

Este exemplo demonstra como atribuir um único utilizador, como patrocinador, a uma conta de utilizador alvo.

• O -UserId parâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador. Pode usar -UserPrincipalName, -Identity, -UPN, -ObjectId como um alias para -UserId.
• O -Type parâmetro especifica o tipo de patrocinador atribuído ao utilizador. Os tipos de patrocinadores suportados são (Utilizador ou Grupo).
• O -SponsorIds parâmetro especifica os IDs dos patrocinadores a serem atribuídos ao utilizador.

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

Este exemplo demonstra como atribuir um único grupo, como patrocinador, a uma conta de utilizador alvo.

• O -UserId parâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador. Pode usar -UserPrincipalName, -Identity, -UPN, -ObjectId como um alias para -UserId.
• O -Type parâmetro especifica o tipo de patrocinador atribuído ao utilizador. Os tipos de patrocinadores suportados são (Utilizador ou Grupo).
• O -SponsorIds parâmetro especifica os IDs dos patrocinadores a serem atribuídos ao utilizador.

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

Este exemplo demonstra como atribuir múltiplos utilizadores como patrocinadores a uma conta de utilizador alvo.

• O -UserId parâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador. Pode usar -UserPrincipalName, -Identity, -UPN, -ObjectId como um alias para -UserId.
• O -Type parâmetro especifica o tipo de patrocinador atribuído ao utilizador. Os tipos de patrocinadores suportados são (Utilizador ou Grupo).
• O -SponsorIds parâmetro especifica os IDs dos patrocinadores a serem atribuídos ao utilizador.

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

Este exemplo demonstra como atribuir múltiplos grupos como patrocinadores a uma conta de utilizador alvo.

• O -UserId parâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador. Pode usar -UserPrincipalName, -Identity, -UPN, -ObjectId como um alias para -UserId.
• O -Type parâmetro especifica o tipo de patrocinador atribuído ao utilizador. Os tipos de patrocinadores suportados são (Utilizador ou Grupo).
• O -SponsorIds parâmetro especifica os IDs dos patrocinadores a serem atribuídos ao utilizador.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.