New-EntraUserAppRoleAssignment

New-EntraUserAppRoleAssignment

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

该 New-EntraUserAppRoleAssignment cmdlet 将用户分配到Microsoft Entra ID中的应用程序角色。

在工作或学校帐户的委托方案中，登录用户必须具有受支持的Microsoft Entra角色或具有所需权限的自定义角色。 支持的角色包括：

• 目录同步帐户（适用于 Entra Connect 和云同步）
• 目录生成器
• 混合标识管理员
• 身份治理管理员
• 特权角色管理员
• 用户管理员
• 应用程序管理员
• 云应用程序管理员

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

此命令将用户分配到没有任何角色的应用程序。

• -UserId 参数指定要向其分配应用角色的用户的 ID。
• -PrincipalId 参数指定要向其分配应用角色的用户的 ID。
• -ResourceId 参数指定已定义应用角色的资源 servicePrincipal 的 ID。
• -AppRoleId 参数指定要分配给用户的 appRole 的 ID（在资源服务主体上定义）。

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

此示例演示如何将用户分配到Microsoft Entra ID中的应用程序角色。

• -UserId 参数指定要向其分配应用角色的用户的 ID。
• -PrincipalId 参数指定要向其分配应用角色的用户的 ID。
• -ResourceId 参数指定已定义应用角色的资源 servicePrincipal 的 ID。
• -AppRoleId 参数指定要分配给用户的 appRole 的 ID（在资源服务主体上定义）。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。