Delete all Access Package assignments for a Specific User

Dan Peters 31 Reputation points
2024-09-27T16:43:41.38+00:00

Hello,

Microsoft has a great script to remove a specific user from a specific Access Package in Azure ID Governance, but I was wondering if there is a way to modify this code to have the script loop through all the Access Packages and remove the specified user from them, as the use case is removing the assignment when the employee is offboarded. Thanks! The link is here: https://video2.skills-academy.com/en-us/entra/id-governance/entitlement-management-access-package-assignments

and the code is below.

Connect-MgGraph -Scopes "EntitlementManagement.ReadWrite.All"
$accessPackageId = "9f573551-f8e2-48f4-bf48-06efbb37c7b8"
$userId = "11bb11bb-cc22-dd33-ee44-55ff55ff55ff"
$filter = "accessPackage/Id eq '" + $accessPackageId + "' and state eq 'Delivered' and target/objectId eq '" + $userId + "'"
$assignment = Get-MgEntitlementManagementAssignment -Filter $filter -ExpandProperty target -all -ErrorAction stop
if ($assignment -ne $null) {
   $params = @{
      requestType = "adminRemove"
      assignment = @{ id = $assignment.id }
   }
   New-MgEntitlementManagementAssignmentRequest -BodyParameter $params
}

Thanks!

Microsoft Identity Manager
Microsoft Identity Manager
A family of Microsoft products that manage a user's digital identity using identity synchronization, certificate management, and user provisioning.
691 questions
0 comments No comments
{count} votes

Accepted answer
  1. youzedev@gmail.com 640 Reputation points
    2024-09-27T16:52:58.0333333+00:00

    To modify the script to loop through all access packages and remove the specified user from each of them, you can query all the access packages first, then loop through each package and perform the removal operation if the user has an assignment. Here’s an updated version of the script:

    Script to Remove a User from All Access PackagesScript to Remove a User from All Access Packages

    Connect to Microsoft Graph API with the necessary scopes

    Connect-MgGraph -Scopes "EntitlementManagement.ReadWrite.All"

    Specify the user ID you want to remove from all access packages

    $userId = "11bb11bb-cc22-dd33-ee44-55ff55ff55ff"

    Retrieve all Access Packages

    $accessPackages = Get-MgEntitlementManagementAccessPackage -All -ErrorAction Stop

    foreach ($accessPackage in $accessPackages) {

    # Get the Access Package ID
    
    $accessPackageId = $accessPackage.Id
    
    # Filter for any assignment where the user has been assigned this package and it's in 'Delivered' state
    
    $filter = "accessPackage/Id eq '" + $accessPackageId + "' and state eq 'Delivered' and target/objectId eq '" + $userId + "'"
    
    $assignment = Get-MgEntitlementManagementAssignment -Filter $filter -ExpandProperty target -All -ErrorAction Stop
    
    # If there's an active assignment, proceed with removal
    
    if ($assignment -ne $null) {
    
        $params = @{
    
            requestType = "adminRemove"
    
            assignment = @{ id = $assignment.id }
    
        }
    
        # Request to remove the assignment
    
        New-MgEntitlementManagementAssignmentRequest -BodyParameter $params
    
        Write-Host "Removed user from Access Package: $($accessPackage.DisplayName)"
    
    } else {
    
        Write-Host "No active assignment found for user in Access Package: $($accessPackage.DisplayName)"
    
    }
    

    }

    Disconnect from Microsoft Graph API

    Disconnect-MgGraph

    Breakdown of Changes:

    1.	Get All Access Packages:
    
    •	Get-MgEntitlementManagementAccessPackage -All retrieves all available access packages.
    
    2.	Loop Through Each Access Package:
    
    •	The script loops through each access package ($accessPackages) to check if the specified user ($userId) has an active assignment in the package.
    
    3.	Check for Active Assignment:
    
    •	For each access package, it filters the assignment by checking the state ('Delivered') and the objectId of the user.
    
    4.	Remove Assignment:
    
    •	If the user has an assignment in the access package, the script constructs the removal request (adminRemove) and executes it using New-MgEntitlementManagementAssignmentRequest.
    
    5.	Logging:
    
    •	The script logs either the removal of the user from the access package or indicates that no active assignment was found.
    

    Things to Ensure:

    •	Make sure you have the necessary Microsoft Graph API permissions (EntitlementManagement.ReadWrite.All) to perform these operations.
    
    •	You should also have administrative privileges in the Azure AD tenant to manage access packages and assignments.
    

    This modified script will remove the specified user from all access packages they are currently assigned to.

    If my answer is helpful to you, you can adopt it, thank you!

    1 person found this answer helpful.

0 additional answers

Sort by: Most helpful

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.