New-EntraUserAppRoleAssignment

New-EntraUserAppRoleAssignment

    -UserId <String>
    -PrincipalId <String>
    -AppRoleId <String>
    -ResourceId <String>
    [<CommonParameters>]

De New-EntraUserAppRoleAssignment cmdlet wijst een gebruiker toe aan een toepassingsrol in Microsoft Entra ID.

In gedelegeerde scenario's met werk- of schoolaccounts moet de aangemelde gebruiker beschikken over een ondersteunde Microsoft Entra-rol of een aangepaste rol met de vereiste machtigingen. Ondersteunde rollen zijn onder andere:

• Adreslijstsynchronisatieaccounts (voor Entra Connect en Cloud Sync)
• Mapschrijver
• Hybrid Identity-beheerder
• Identity Governance-beheerder
• Bevoorrechte Rollenbeheerder
• Gebruikersbeheerder
• Toepassingsbeheerder
• Cloudtoepassingsbeheerder

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$appId = (Get-EntraApplication -SearchString '<App-DisplayName>').AppId
$user = Get-EntraUser -SearchString '<UserPrincipalName>'
$servicePrincipal = Get-EntraServicePrincipal -Filter "appId eq '$appId'"
$params = @{
    UserId      = $user.Id
    PrincipalId = $user.Id
    ResourceId  = $servicePrincipal.Id
    AppRoleId   = [Guid]::Empty
}
New-EntraUserAppRoleAssignment @params

DeletedDateTime Id                                          AppRoleId                            CreatedDateTime     PrincipalDisplayName PrincipalId                          PrincipalType ResourceDisplayName
--------------- --                                          ---------                            ---------------     -------------------- -----------                          ------------- ------------------- -
                A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u 00aa00aa-bb11-cc22-dd33-44ee44ee44ee 18-06-2024 11:22:40 UserPrincipalName          aaaaaaaa-bbbb-cccc-1111-222222222222 User          App-DisplayName

Met deze opdracht wordt een gebruiker toegewezen aan een toepassing die geen rollen heeft.

• -UserId parameter geeft de id op van een gebruiker aan wie u de app-rol toewijst.
• -PrincipalId parameter geeft de id op van een gebruiker aan wie u de app-rol toewijst.
• -ResourceId parameter geeft de id op van een resourceservicePrincipal die de app-rol heeft gedefinieerd.
• -AppRoleId parameter specificeert de id van een appRole (gedefinieerd in de resourceservice-principal) die moet worden toegewezen aan de gebruiker.

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Box'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
$params = @{
    UserId      = $user.Id
    PrincipalId = $user.Id
    ResourceId  = $servicePrincipal.Id
    AppRoleId   = $servicePrincipal.AppRoles[1].Id
}
New-EntraUserAppRoleAssignment @params

DeletedDateTime Id                                          AppRoleId                            CreatedDateTime     PrincipalDisplayName PrincipalId                          PrincipalType ResourceDisplayName
--------------- --                                          ---------                            ---------------     -------------------- -----------                          ------------- -------------------
                A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u 00aa00aa-bb11-cc22-dd33-44ee44ee44ee 06/18/2024 09:47:00 Sawyer Miller        1aaaaaa1-2bb2-3cc3-4dd4-5eeeeeeeeee5 User          Box

In dit voorbeeld ziet u hoe u een gebruiker toewijst aan een toepassingsrol in Microsoft Entra ID.

• -UserId parameter geeft de id op van een gebruiker aan wie u de app-rol toewijst.
• -PrincipalId parameter geeft de id op van een gebruiker aan wie u de app-rol toewijst.
• -ResourceId parameter geeft de id op van een resourceservicePrincipal die de app-rol heeft gedefinieerd.
• -AppRoleId parameter specificeert de id van een appRole (gedefinieerd in de resourceservice-principal) die moet worden toegewezen aan de gebruiker.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.