[ E N T R A   P I M ]

Manage Microsoft Entra PIM roles from your terminal.

Entra ID roles, Azure Resource roles, and Groups PIM — one PowerShell command.

Install Now GitHub
v2.3.1 · PowerShell 7.0+

Features

Everything you need to manage PIM roles, in one tool.

🔐

Full PIM Support

Manage Entra ID roles, Azure Resource roles, and Groups PIM memberships from a single interactive console.

🛡

Secure by Design

Fresh browser-based authentication on every launch. Supports Conditional Access policies, authentication context, and automatic step-up MFA for privileged roles.

🌐

Cross-Platform

Works on Windows and macOS. No cached tokens — every session authenticates through your identity provider with full policy enforcement.

Smart Duration

If requested duration exceeds a role's policy maximum, each role activates for its individual policy limit.

Interactive TUI

Navigate with keyboard shortcuts, back navigation on every menu, and live countdown timers on active roles.

🔄

Auto-Updates

Automatically checks PowerShell Gallery for new versions and prompts to update with the correct install method.

📦

Zero Config

Auto-installs required modules on first run. No app registration needed — just install and go.

Batch Activate & Deactivate

Select multiple roles at once and activate or deactivate them all in a single flow. Per-role status feedback with success, fail, and skipped summaries.

🔑

Custom App Registration

Optionally bring your own app registration with Configure-EntraPIM. Supports authentication context for granular Conditional Access policy targeting on privileged roles.

See It in Action

Full activation workflow — authentication, role selection, and activation.

Screenshots

The interactive console experience.

Workflow Selector - Choose between Entra ID, Group, or Azure roles
Workflow Selector
Action Menu - Activate or Deactivate roles
Action Menu
Role Selection - Choose roles to activate
Role Selection
Activation Results - Roles activated with step-up MFA
Activation Results

Quick Start

Up and running in two commands.

Install
Install-Module -Name Entra-PIM -Repository PSGallery
Run
Start-EntraPIM
Optional: Custom App Registration
# Configure once, use anytime
Configure-EntraPIM

Keyboard Shortcuts

Navigate the TUI with ease.

ShortcutAction
Navigate
SpaceToggle selection
Ctrl+ASelect all
Ctrl+DDeselect all
EnterConfirm
EscStep back
Ctrl+HHelp
Ctrl+QExit

API Permissions

Required only when using a custom app registration.

Entra ID & Azure Roles

  • User.Read
  • RoleAssignmentSchedule.ReadWrite.Directory
  • RoleEligibilitySchedule.ReadWrite.Directory
  • RoleManagement.Read.Directory
  • RoleManagementPolicy.Read.Directory

Groups PIM (Additional)

  • PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup
  • PrivilegedEligibilitySchedule.Read.AzureADGroup
  • RoleManagementPolicy.Read.AzureADGroup