PimRoleTools

2.0.0

PowerShell module for managing Azure AD (Entra ID) and Group Privileged Identity Management (PIM) roles. Supports role activation, monitoring, and management with an enhanced user experience.

Minimum PowerShell version

7.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name PimRoleTools

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name PimRoleTools

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) Mike Guimaraes. All rights reserved.

Package Details

Author(s)

  • Mike Guimaraes

Tags

PIM PrivilegedIdentityManagement Azure AzureAD EntraID Security RBAC Governance

Functions

Connect-PimGraph Get-PimRole Enable-PimRole Disable-PimRole Show-PimRole Get-PimGroupRole Enable-PimGroupRole Get-PimSummary

PSEditions

Core

Dependencies

Release Notes

# Version 2.0.0
## Major Features
- Complete rewrite with enhanced functionality and user experience
- Added support for PIM group memberships
- New comprehensive summary view with Get-PimSummary
- Enhanced error handling and visual feedback

## New Functions
- Connect-PimGraph: Dedicated connection management with automatic scope handling
- Get-PimGroupRole: List PIM group assignments (member/owner)
- Enable-PimGroupRole: Activate PIM group membership
- Disable-PimRole: Deactivate active Azure AD roles
- Get-PimSummary: Comprehensive overview of all PIM assignments

## Improvements
- Color-coded output with emoji indicators for better readability
- Support for wildcards in role name searches
- Real-time remaining duration calculations with smart formatting
- Animated spinner during role activation with timeout handling
- Enhanced error messages with actionable guidance
- Support for ticket systems and audit information
- Streamlined API calls with better performance

## Focus
- Concentrated on Azure AD/Entra ID and Group PIM for reliable functionality
- Removed Azure Resource PIM due to API limitations (use Azure Portal instead)

FileList

Version History

Version Downloads Last updated
2.0.0 (current version) 5 7/30/2025