-find_users

Syntax: -find_users

You can use the -find_users parameter to perform a quick search for user accounts in a BlackBerry Enterprise Service 10 domain. The -find_users parameter is optimized to display a large number of search results.

Optional parameters and subparameters are enclosed in square brackets ( [ ] ).

-find_users : display information for specified users
	[-display_name <display name>] : search the display name
	[-login_name <login name>] : search the login name
	[-email_address <email address>] : search the email address
	[-group_name <group name>] : search the group name
	[-dispatcher <dispatcher name>] : instance name of the BlackBerry Device
					Service component
	[-max_results <numeric value>] : limit the number of results returned
	[-extended] : show extended data
	[-default_activation_type <type>] : search the activation type for new
					and reactivated devices for -
					blackberry_balance,work_space_only
	[-device_activation_state <state>] : search the device activation state
					for - blackberry_balance, work_space_only
	[-wireless_service_plan_tier <tier>] : search the device wireless service plan
					 tier for - enterprise, personal, none
	[-device_out_of_compliance] : search for devices that are not in a
					state of compliance
	or
	[-device_in_compliance] : search for devices that are in a state of compliance

Subparameter

Description

[-default_activation_type <type>]

This subparameter specifies the default activation type (how a device was initially activated) of one or more user accounts that you want to search for:
  • blackberry_balance: The personal space and the work space are available on the BlackBerry device. This activation type requires an EMM Corporate license.
  • work_space_only: Only the work space is available on the device. This activation type requires an EMM Corporate license and a device running BlackBerry 10 OS version 10.1 or later and a service plan that supports this feature.

[-device_activation_state <state>]

This subparameter specifies the current activation state of one or more user accounts that you want to search for:
  • blackberry_balance: The personal space and the work space are available on the BlackBerry device. This activation type requires an EMM Corporate license.
  • work_space_only: Only the work space is available on the device. This activation type requires an EMM Corporate license and a device running BlackBerry 10 OS version 10.1 or later and a service plan that supports this feature.

[-device_in_compliance]

This subparameter searches for devices that are in compliance with the BlackBerry Device Service.

[-device_out_of_compliance]

This subparameter searches for devices that are not in compliance with the BlackBerry Device Service.

[-dispatcher <dispatcher_name>]

This subparameter specifies the name of the BlackBerry Device Service instance that is associated with one or more user accounts that you want to search for. Use the name of the BlackBerry Device Service as it appears in the BlackBerry Administration Service.

[-display_name <display_name>]

This subparameter specifies the display name of the user account that you want to search for.

[-email_address <email_address>]

This subparameter specifies the email address of the user account that you want to search for.

[-extended]

This subparameter displays more detailed results.

[-group_name <group>]

This subparameter specifies the name of the group that is associated with one or more user accounts that you want to search for.

[-login_name <login_name>]

This subparameter specifies the login name of the user account that you want to search for.

[-max_results <max_number>]

This subparameter specifies the maximum number of results to display.

[-wireless_service_plan_tier <tier>]

This subparameter specifies the wireless service plan of one or more user accounts that you want to search for:
  • enterprise
  • personal
  • none


Was this information helpful? Send us your comments.