Get FalconRole - CrowdStrike/psfalcon GitHub Wiki

Get-FalconRole

SYNOPSIS

Search for user roles and assignments

DESCRIPTION

Requires 'User management: Read'.

PARAMETERS

Name Type Description Min Max Allowed Pipeline PipelineByName
Id String[] Role identifier X X
UserId String User identifier
Cid String Customer identifier
DirectOnly Boolean Display direct user role grants
Filter String Falcon Query Language expression to limit results

role_name
role_id
Sort String Property and direction to sort results cid|asc
cid|desc
role_name|asc
role_name|desc
type|asc
type|desc
Limit Int32 Maximum number of results per request 1 500
Detailed Switch Retrieve detailed information
Offset String Position to begin retrieving results
All Switch Repeat requests until all available results are retrieved
Total Switch Display total result count instead of results

SYNTAX

Get-FalconRole [-Cid <String>] [-Detailed] [-WhatIf] [-Confirm] [<CommonParameters>]
Get-FalconRole -Id <String[]> [[-Cid] <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
Get-FalconRole -UserId <String> [[-Cid] <String>] [[-DirectOnly] <Boolean>] [[-Filter] <String>] [[-Sort] <String>] [[-Limit] <Int32>] [-Offset <String>] [-All] [-Total] [-WhatIf] [-Confirm] [<CommonParameters>]

REFERENCE

Endpoints

GET /user-management/combined/user-roles/v2
GET /user-management/queries/roles/v1
POST /user-management/entities/roles/GET/v2

falconpy

queriesRolesV1
entitiesRolesGETV2
CombinedUserRolesV2

USAGE

List all available user roles

Get-FalconRole [-Detailed]

List roles assigned to a user

Get-FalconRole -UserId <id>

2025-09-19: PSFalcon v2.2.9

⚠️ **GitHub.com Fallback** ⚠️