Power BI Security Skill
Manage row-level security (RLS) and perspectives for Power BI models.
Prerequisites
pipx install pbi-cli-tool
pbi-cli skills install
pbi connect
Security Roles (RLS)
# List all security roles
pbi security-role list
# Get role details
pbi security-role get "Regional Manager"
# Create a new role
pbi security-role create "Regional Manager" \
--description "Restricts data to user's region"
# Delete a role
pbi security-role delete "Regional Manager"
Perspectives
Perspectives control which tables and columns are visible to users:
# List all perspectives
pbi perspective list
# Create a perspective
pbi perspective create "Sales View"
# Delete a perspective
pbi perspective delete "Sales View"
Workflow: Set Up RLS
# 1. Create roles
pbi security-role create "Sales Team" --description "Sales data only"
pbi security-role create "Finance Team" --description "Finance data only"
# 2. Verify roles were created
pbi --json security-role list
# 3. Export full model for version control (includes roles)
pbi database export-tmdl ./model-backup/
Workflow: Create User-Focused Perspectives
# 1. Create perspectives for different audiences
pbi perspective create "Executive Dashboard"
pbi perspective create "Sales Detail"
pbi perspective create "Finance Overview"
# 2. Verify
pbi --json perspective list
Common RLS Patterns
Region-Based Security
Create a role that filters by the authenticated user's region:
pbi security-role create "Region Filter" \
--description "Users see only their region's data"
Then define table permissions with DAX filter expressions in the model (via TMDL or Power BI Desktop).
Department-Based Security
pbi security-role create "Department Filter" \
--description "Users see only their department's data"
Manager Hierarchy
pbi security-role create "Manager View" \
--description "Managers see their direct reports' data"
Best Practices
- Create roles with clear, descriptive names
- Always add descriptions explaining the access restriction
- Export model as TMDL for version control (
pbi database export-tmdl) - Test RLS thoroughly before publishing to production
- Use perspectives to simplify the model for different user groups
- Document role-to-group mappings externally (RLS roles map to Azure AD groups in Power BI Service)
- Use
--jsonoutput for automated security audits:pbi --json security-role list