Skip to content

Get FalconUser

bk-cs edited this page Jan 17, 2023 · 25 revisions

Get-FalconUser

SYNOPSIS

Search for users

DESCRIPTION

Requires 'User Management: Read'.

PARAMETERS

Name Type Min Max Allowed Pipeline PipelineByName Description
Id String[] X X User identifier
Filter String Falcon Query Language expression to limit results

assigned_cids
cid
first_name
last_name
name
uid
Sort String first_name|asc
first_name|desc
last_name|asc
last_name|desc
name|asc
name|desc
uid|asc
uid|desc
Property and direction to sort results
Limit Int32 1 500 Maximum number of results per request
Offset Int32 Position to begin retrieving results
Username String[] Username
Include String[] roles Include additional properties
Detailed Switch Retrieve detailed information
All Switch Repeat requests until all available results are retrieved
Total Switch Display total result count instead of results

SYNTAX

Get-FalconUser [[-Filter] <String>] [[-Sort] <String>] [[-Limit] <Int32>] [[-Offset] <Int32>] [-Include <String[]>] [-Detailed] [-All] [-Total] [-WhatIf] [-Confirm] [<CommonParameters>]
Get-FalconUser [-Id] <String[]> [-Include <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Get-FalconUser -Username <String[]> [-Include <String[]>] [-Detailed] [-WhatIf] [-Confirm] [<CommonParameters>]

SDK Reference

falconpy

queryUserV1
retrieveUsersGETV1

USAGE

List all user IDs

Get-FalconUser

Find a user ID by username

Get-FalconUser -Username jane.doe@example.com

List all users and their details

Get-FalconUser -Detailed

NOTE: The -Include parameter can be used to append user roles to Get-FalconUser output.

Get details on one or more users

Get-FalconUser -Id <id>, <id>

2023-01-17: PSFalcon v2.2.4

Clone this wiki locally