Blackberry SWD-504685-0330050601-001 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Blackberry SWD-504685-0330050601-001, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Blackberry SWD-504685-0330050601-001 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Blackberry SWD-504685-0330050601-001. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Blackberry SWD-504685-0330050601-001 should contain:
- informations concerning technical data of Blackberry SWD-504685-0330050601-001
- name of the manufacturer and a year of construction of the Blackberry SWD-504685-0330050601-001 item
- rules of operation, control and maintenance of the Blackberry SWD-504685-0330050601-001 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Blackberry SWD-504685-0330050601-001 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Blackberry SWD-504685-0330050601-001, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Blackberry service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Blackberry SWD-504685-0330050601-001.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Blackberry SWD-504685-0330050601-001 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    BlackBerry Enterprise Server Resource Kit BlackBerry Enterprise Server User Administration Tool Version: 5.0 Administration Guide[...]

  • Page 2

    SWD-504685-0330050601-001[...]

  • Page 3

    Contents 1 Overview ....................................................................................................................................................................................... 5 BlackBerry Enterprise Server User Administration Tool ..........................................................................................[...]

  • Page 4

    List the folders that are available for email message forwarding ............................................................................................. 23 Turn on or turn off email message forwarding for folders ......................................................................................................... 24 4 Managing IT policies[...]

  • Page 5

    Check the status of the BlackBerry Enterprise Server User Administration Tool ................................................................... 41 Configuring log files ....................................................................................................................................................................... 41 11 Param[...]

  • Page 6

    30 -set_password .............................................................................................................................................................................. 81 31 -set_user_itpolicy_rule ................................................................................................................................[...]

  • Page 7

    Overview 1 The BlackBerry® Enterprise Server Resource Kit is a collection of tools that can help you extend your ability to manage and monitor the BlackBerry® Enterprise Solution. You can download the BlackBerry Enterprise Server Resource Kit from www.blackberry.com/support/downloads . The BlackBerry Enterprise Server Resource Kit contains the fo[...]

  • Page 8

    Permission name Security role Enterprise role Senior Helpdesk role Junior Helpdesk role Server only role User only role Create a user * * * * Delete a user * * * * View a user (across Group) * * * * * Edit a user (across Group) * * * * View a device (across Group) * * * * * Edit a device (across Group) * * * * * View device activation settings * * [...]

  • Page 9

    Permission name Security role Enterprise role Senior Helpdesk role Junior Helpdesk role Server only role User only role View an application * * * * * Edit an application * * * Delete an application * * * Create an administrator user * * * Specify activation password * * * * * Turn off and on external services * * * * Clear activation password * * *[...]

  • Page 10

    Permission name Security role Enterprise role Senior Helpdesk role Junior Helpdesk role Server only role User only role Edit a job * * * View default distribution settings for a job * * * Edit default distribution settings for a job * * * Update peer-to-peer encryption key * * * View job distribution settings * * * Edit job distribution settings * [...]

  • Page 11

    Permission name Security role Enterprise role Senior Helpdesk role Junior Helpdesk role Server only role User only role View a group across organizations Edit a group across organizations Add and remove a role across organizations View a device across organizations Edit a device across organizations Register an event notification Create an event no[...]

  • Page 12

    Tool Description BlackBerry IT Policy Template Reporting Tool (ITPolicyTemplateReport.exe) To display the preconfigured IT policies that are available on a BlackBerry® Enterprise Server, in the BlackBerry Enterprise Server User Administration Tool, you can run the following command: besuseradminclient < credentials > -list -it_policy_templat[...]

  • Page 13

    Parameter Description -stats -service -b < instance > and -stats -service -email < instance > These subparameters display statistics for a BlackBerry Enterprise Server component or for a BlackBerry Messaging Agent instance. They replace the following subparameters: • -stats -b < instance > • -stats -servers -v < level > [...]

  • Page 14

    Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool If your organization uses applications that work with previous versions of the BlackBerry® Enterprise Server User Administration Tool, in many cases, these applications also work with version 5.0 of the tool. Supported authen[...]

  • Page 15

    Syntax for authentication credentials In the BlackBerry® Enterprise Server User Administration Tool BlackBerry Enterprise Server User Administration Tool, the variable < credentials > represents the user name and password that you use for authentication with the BlackBerry Administration Service. The BlackBerry Enterprise Server User Adminis[...]

  • Page 16

    Extracting credentials that are stored in the Windows registry The BlackBerry® Enterprise Server User Administration Tool uses the -p < password > command to extract and decrypt credentials that are stored in the Windows® registry and then inserts the credentials into the command line options. Example BESUserAdminClient -p password1 -status[...]

  • Page 17

    BlackBerry Enterprise Server User Administration Tool version 4.1.x BlackBerry Enterprise Server User Administration Tool version 5.0 Run the following command: BESUserAdminClient -p password1 -sqluser SQLU1 -sqlpass SQLP1 ... Initial configuration (perform once): 1. Create a BlackBerry Administration Service administrator with the following creden[...]

  • Page 18

    Example: Changing the authentication credentials in the Windows registry to a Microsoft Active Directory user BlackBerry Enterprise Server User Administration Tool version 4.1.x BlackBerry Enterprise Server User Administration Tool version 5.0 Not applicable Run the following command: BESUserAdminClient -set_client_auth "-username ADU1 -passwo[...]

  • Page 19

    Managing user accounts 2 The BlackBerry® Enterprise Server uses predefined roles that correspond to common administrative roles in organizations to control who can perform specific tasks and to limit who can access sensitive data. The BlackBerry Enterprise Server User Administration Tool uses the BlackBerry Administration Service credentials that [...]

  • Page 20

    Add a new user account to a group 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Administration Tool > BlackBerry Enterprise Server Us[...]

  • Page 21

    Example besuseradminclient -username admin -password password - assign_swconfig -u "sam, moser” -b server1 -sw games Finding user accounts Find a user account You can use the -u subparameter to specify the user account that the BlackBerry® Enterprise Server User Administration Tool searches for. 1. To open the command window for the BlackBe[...]

  • Page 22

    Move a user account to a different user group A user account can belong to more than one group. You can perform this task if you want the user account to belong to only the group that you specify. Before you begin: Delete the user account from the existing group. 1. To open the command window for the BlackBerry® Enterprise Server User Administrati[...]

  • Page 23

    Example besuseradminclient -username admin -password password -assign_swconfig -csw config1 -u “sam, moser” -b server1 Delete a user account from the BlackBerry Enterprise Server 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Pr[...]

  • Page 24

    List the groups in a BlackBerry Domain 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Administration Tool > BlackBerry Enterprise Serv[...]

  • Page 25

    Managing email message forwarding 3 Turn on or turn off email message forwarding The BlackBerry® Enterprise Server for MDS Applications does not support this task. By default, email message forwarding is turned off. 1. To open the command window for the BlackBerry Enterprise Server User Administration Tool, on the computer that hosts the tool, on [...]

  • Page 26

    besuseradminclient -username admin -password password -list -folders -u sammoser -b server01 Turn on or turn off email message forwarding for folders The BlackBerry® Enterprise Server for MDS Applications does not support this task. If you are using the BlackBerry® Enterprise Server for Microsoft® Exchange, a folder name can contain a slash mark[...]

  • Page 27

    Managing IT policies and IT policy rules 4 List the IT policy rules in an IT policy 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Admini[...]

  • Page 28

    Advanced Security, Security, External File System Encryption Level, Encrypt to User Password (excluding multi-media directories), ENUMERATION: 0|Not Required|1|Encrypt to User Password (excluding multi-media directories)|2|Encrypt to User Password (including multi-media directories)|3|Encrypt to Device Key (excluding multi-media directories)|4|Encr[...]

  • Page 29

    Managing BlackBerry devices 5 Set a password for a BlackBerry device 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Administration Tool &[...]

  • Page 30

    Example: Setting owner information on a BlackBerry device besuseradminclient -username admin -password password -set_owner_info -info "Sam Moser" -u smoser@test.rim.net -b server01 Example: Setting owner information on a BlackBerry device using an input file besuseradminclient -username admin -password password -infofile userinformation.t[...]

  • Page 31

    Resend the peer-to-peer encryption key 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Administration Tool > BlackBerry Enterprise Serv[...]

  • Page 32

    Sending notification messages to BlackBerry devices 6 Send a notification PIN message 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Admi[...]

  • Page 33

    Send a notification email message The BlackBerry® Enterprise Server for MDS Applications does not support this task. 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackB[...]

  • Page 34

    Retrieving user account statistics and information about BlackBerry devices 7 Retrieve user account statistics 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry En[...]

  • Page 35

    Column Description ServerDN canonical name of the BlackBerry Enterprise Server that stores the user account that is associated with the BlackBerry device PIN PIN of the BlackBerry device Device Type model number of the BlackBerry device State state of messages on the BlackBerry device (regardless of whether the BlackBerry device is turned on or tur[...]

  • Page 36

    Clear user account statistics 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Administration Tool > BlackBerry Enterprise Server User A[...]

  • Page 37

    /O=RIM/OU=r1/cn=Configuration/cn=Servers/cn=Server01-SBRK/cn=Mail Private MDB sammoser@test.rim.net COMPLETED 180 Service books accepted 20090119 08:20:59.603 Administration Guide Retrieve enterprise activation statistics for a user account 35[...]

  • Page 38

    Retrieving BlackBerry device information 8 List the applications that are available on one or more BlackBerry devices 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackB[...]

  • Page 39

    • -users < user_device_information > • -g < group_name > • -b < instance > Example: Retrieving the statistics for a user account besuseradminclient -username admin -password password1 -handheld_info -hhstats -u “CN=Sam Moser/O=Server01” -b server1 Example: Retrieving the statistics for all user accounts in a group besuse[...]

  • Page 40

    Column Description IT Policy Time time that the BlackBerry Enterprise Server last sent the IT policy to the BlackBerry device Configuration Name name of the software configuration that is assigned to the BlackBerry device Configuration Status overall status of the software configuration that is installed on the BlackBerry device System Status statu[...]

  • Page 41

    Retrieve statistics for the BlackBerry Enterprise Server or the messaging server 9 1. To open the command window for the BlackBerry® Enterprise Server User Administration Tool, on the computer that hosts the tool, on the taskbar, click Start > Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Enterprise Server User Adminis[...]

  • Page 42

    Column Description Name name of the BlackBerry Enterprise Server instance Status status of the BlackBerry Enterprise Server instance Forwarded number of messages that the BlackBerry Enterprise Server instance forwarded Sent number of messages and organizer data items that the BlackBerry Enterprise Server instance sent Pending number of messages and[...]

  • Page 43

    Troubleshooting the BlackBerry Enterprise Server User Administration Tool 10 Check the status of the BlackBerry Enterprise Server User Administration Tool You can use this command to verify that there is a valid connection between the BlackBerry® Administration Service and the BlackBerry Enterprise Server User Administration Tool and that that the[...]

  • Page 44

    • WARN • ERROR • FATAL TRACE provides the most information, and FATAL provides the least. (To change the level of the output that is displayed on the console, use the -v option.) The bua-config.properties file also controls the platform type, in the line PLATFORM=< value >. The platform options are the following: • DOMINO • EXCHANGE[...]

  • Page 45

    Parameters for the BlackBerry Enterprise Server User Administration Tool 11 Using the command summary in the help file To open the help file for the BlackBerry® Enterprise Server User Administration Tool, you type besuseradminclient and one of the following parameters: • -? • -h • -help < command > (for help for the specified command) [...]

  • Page 46

    Common parameters 12 The following subparameters are available for use with many of the parameters in the BlackBerry® Enterprise Server User Administration Tool. You can use the command syntax to help you determine whether you can use a subparameter in a particular case. Subparameter Description -b < instance > This subparameter specifies th[...]

  • Page 47

    Input, output, and user feedback parameters 13 Subparameter Description -i < input_filename > This subparameter specifies the name of an input file. You can use an input file for any parameter that has command line options. The first line of the input file is a comma-separated list of options that the columns represent. This list can be any n[...]

  • Page 48

    Subparameter Description -o < output_filename > This subparameter specifies the file that stores output information. -password < password > This subparameter specifies the password that the administrator uses to authenticate with the BlackBerry® Administration Service. -username < user_name > This subparameter specifies the authe[...]

  • Page 49

    -add 14 You can use the -add parameter to add a user account to a BlackBerry® Enterprise Server instance. Syntax: -add -add : add user -u <user name> : user name -b <instance> : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_address, canonical_name or -pin <PIN>[...]

  • Page 50

    Subparameter Description -cs This subparameter clears the account statistics of an existing user account. By default, when you add a user account, the BlackBerry Enterprise Server User Administration Tool reads the existing statistics for the user account. -group < group_name > This subparameter specifies the name of the user group that you w[...]

  • Page 51

    Subparameter Description • display_name • email_address • canonical_name • login_name: name that the account uses to log in to the BlackBerry Administration Service Searches are not case sensitive and appear in the order DisplayName, EmailAddress, UserName, and MailboxId. Most matches are prefix matches. -w < password > This subparame[...]

  • Page 52

    -assign_swconfig 15 You can use the -assign_swconfig parameter to assign a software configuration to a user or a user group. Syntax: -assign_swconfig -assign_swconfig : assign software configuration -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type [...]

  • Page 53

    Subparameter Description -utype < type > This subparameter specifies which of the following options the BlackBerry Enterprise Server User Administration Tool uses to search for the user account: • display_name • email_address • canonical_name • login_name: name that the account uses to log in to the BlackBerry Administration Service S[...]

  • Page 54

    -change 16 You can use the -change parameter to make changes to configuration settings for user accounts and to delete pending messages. Syntax: -change -change : change user configuration -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_[...]

  • Page 55

    Subparameters: -change Subparameter Description -addrsub < address_book_name > This subparameter specifies the name of the address book that you want to synchronize. You can use this subparameter only with the BlackBerry® Enterprise Server for Novell® GroupWise®. -b < instance > This subparameter specifies the BlackBerry Enterprise S[...]

  • Page 56

    Subparameter Description -group < group_name > This subparameter specifies the name of the group that you want to add either a new user account to (-add) or an existing user account to (-change). -it_policy < IT_policy_name > This subparameter specifies the name of the IT policy to apply to the user account. You can view a list of valid[...]

  • Page 57

    Subparameter Description • canonical_name • login_name: name that the account uses to log in to the BlackBerry Administration Service Searches are not case sensitive and appear in the order DisplayName, EmailAddress, UserName, and MailboxId. Most matches are prefix matches. -w < password > This subparameter specifies the password that is [...]

  • Page 58

    -delete 17 You can use the -delete parameter to delete a user account from the BlackBerry® Enterprise Server instance. Syntax: -delete -delete : delete user -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_address, login_name[...]

  • Page 59

    Subparameter Description Searches are not case sensitive and appear in the order DisplayName, EmailAddress, UserName, and MailboxId. Most matches are prefix matches. Administration Guide -delete 57[...]

  • Page 60

    -find 18 You can use the -find parameter to locate a user account in a BlackBerry® Domain. Syntax: -find -find : find user -u <user name> : search string [-utype <type>] : user type - display_name, email_address, login_name, canonical_name Subparameters: -find Subparameter Description -u < user_name > This subparameter specifies [...]

  • Page 61

    -handheld_info 19 You can use the -handheld_info parameter to display BlackBerry® device statistics and applications. Before you run this parameter, you must run the BlackBerry Synchronization Service to populate the database. Syntax: -handheld_info -handheld_info : display handheld stats/applications -hhstats : device stats -u <user name> :[...]

  • Page 62

    Subparameters: -handheld_info Subparameter Description -appname This subparameter specifies the application name to display. This subparameter does not work with the -u or -b subparameters. -apps This subparameter lists the applications on a BlackBerry device. -appsfull This subparameter lists the applications in verbose detail for a user account. [...]

  • Page 63

    Subparameter Description -users This subparameter works with the -hhstats subparameter to specify all user accounts instead of one user account. You can restrict this option by group (-g) or BlackBerry Enterprise Server instance (-b). Administration Guide -handheld_info 61[...]

  • Page 64

    -kill_handheld 20 You can use the -kill_handheld parameter to delete all data from the BlackBerry® device and make the BlackBerry device unavailable. Syntax: -kill_handheld -kill_handheld : kill handheld -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user[...]

  • Page 65

    Subparameter Description Searches are not case sensitive and appear in the order DisplayName, EmailAddress, UserName, and MailboxId. Most matches are prefix matches. Administration Guide -kill_handheld 63[...]

  • Page 66

    -list 21 You can use the -list parameter to provide information about servers, user groups, IT policies, IT policy rules, application control policies, mailbox folders, and enterprise activation status. Syntax: -list -list : list information specified -it_policies : display IT policies or -it_policy_rules : display policy rules [-it_policy <IT p[...]

  • Page 67

    Subparameters: -list Subparameter Description -appconpolicies This subparameter lists all the application control policies. -appconpolicy < app_policy_name > This subparameter lists information about < app_policy_name >. -b < instance > This subparameter specifies the BlackBerry® Enterprise Server instance for the action. You use[...]

  • Page 68

    Subparameter Description • for IBM Lotus Domino: canonical name (for example, “CN=Sam Moser/ O=Server01”) • for Novell GroupWise: user ID (for example, sammoser) • for MDS Applications: PIN of the BlackBerry device -utype < type > This subparameter specifies which of the following options the BlackBerry Enterprise Server User Admini[...]

  • Page 69

    -move 22 You can use the -move parameter to move a user account to a different BlackBerry® Enterprise Server. Syntax: -move -move : move user -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_address, login_name, canonical_nam[...]

  • Page 70

    Subparameter Description • display_name • email_address • canonical_name • login_name: name that the account uses to log in to the BlackBerry Administration Service Searches are not case sensitive and appear in the order DisplayName, EmailAddress, UserName, and MailboxId. Most matches are prefix matches. Administration Guide -move 68[...]

  • Page 71

    -resend_peer_to_peer_key 23 You can use the -resend_peer_to_peer_key parameter to resend a peer-to-peer encryption key to the BlackBerry® device. Syntax: -resend_peer_to_peer_key -resend_peer_to_peer_key : resend peer-to-peer key -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-[...]

  • Page 72

    -resend_service_book 24 You can use the resend_service_book parameter to resend a service book to the BlackBerry® device. Syntax: -resend_service_book -resend_service_book : resend service book -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - di[...]

  • Page 73

    -send_email 25 You can use the -send_email parameter to send an email message to a BlackBerry® device. Syntax: -send_email -send_email : send email message to user or group -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_add[...]

  • Page 74

    Subparameter Description • for IBM® Lotus® Domino®: canonical name (for example, “CN=Sam Moser/ O=Server01”) • for Novell® GroupWise®: user ID (for example, sammoser) • for MDS Applications: display name of the BlackBerry device -utype < type > This subparameter specifies which of the following options the BlackBerry Enterprise[...]

  • Page 75

    -send_pin 26 You can use the -send_pin parameter to send a PIN message to the BlackBerry® device Syntax: -send_pin -send_pin : send pin message to user or group -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_address, login_[...]

  • Page 76

    Subparameter Description • for IBM® Lotus® Domino®: canonical name (for example, “CN=Sam Moser/ O=Server01”) • for Novell® GroupWise®: user ID (for example, sammoser) • for MDS Applications: display name of the BlackBerry device -utype < type > This subparameter specifies which of the following options the BlackBerry Enterprise[...]

  • Page 77

    -set_client_auth 27 You can use the -set_client_auth parameter to specify the client authentication parameters that are stored in the Windows® registry. Syntax: -set_client_auth -set_client_auth <credentials> : client authentication credentials to be stored in registry -set_p <password> : client password for storing authentication cred[...]

  • Page 78

    Subparameter Description You can use this subparameter only in an environment that includes a Microsoft® Exchange messaging server. -mailbox_auth This subparameter specifies that the user authenticates with the BlackBerry Administration Service using mailbox authentication. -p < password > This subparameter specifies the client password that[...]

  • Page 79

    -set_folder_redirection 28 You can use the -set_folder_redirection parameter to forward or stop forwarding email messages from a user account's email message folders. Syntax: -set_folder_redirection -set_folder_redirection : set folder redirection for a user -u <user name> : user name [-b <instance>] : instance name of the BlackBer[...]

  • Page 80

    Subparameter Description -u < user_name > This subparameter specifies the user account for the action. Depending on your organization's BlackBerry Enterprise Server environment, the user account uses one of the following formats: • for Microsoft Exchange: mailbox name (for example, smoser@test.rim.net) • for IBM Lotus Domino: canonic[...]

  • Page 81

    -set_owner_info 29 You can use the -set_owner_info parameter to specify the owner information that appears on the screen of the BlackBerry® device when it is locked. Syntax: -set_owner_info -set_owner_info : set owner information -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-[...]

  • Page 82

    Subparameter Description -utype < type > This subparameter specifies which of the following options the BlackBerry Enterprise Server User Administration Tool uses to search for the user account: • display_name • email_address • canonical_name • login_name: name that the account uses to log in to the BlackBerry Administration Service S[...]

  • Page 83

    -set_password 30 You can use the -set_password parameter to set a password for a BlackBerry® device. Syntax: -set_password -set_password <password> : set device password -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_[...]

  • Page 84

    -set_user_itpolicy_rule 31 You can use the -set_user_itpolicy_rule parameter to specify an IT policy rule for a user account. Syntax: -set_user_itpolicy_rule -set_user_itpolicy_rule : set per user IT policy -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : us[...]

  • Page 85

    Subparameter Description • login_name: name that the account uses to log in to the BlackBerry Administration Service Searches are not case sensitive and appear in the order DisplayName, EmailAddress, UserName, and MailboxId. Most matches are prefix matches. Administration Guide -set_user_itpolicy_rule 83[...]

  • Page 86

    -stats 32 You can use the -stats parameter to retrieve the BlackBerry® Enterprise Server and user account statistics. Syntax: -stats -stats : display user/service stats -u <user name> : user name [-b <instance>] : instance name of the BlackBerry Enterprise Server component [-utype <type>] : user type - display_name, email_address[...]

  • Page 87

    Subparameter Description • for IBM® Lotus® Domino®: canonical name (for example, “CN=Sam Moser/ O=Server01”) • for Novell® GroupWise®: user ID (for example, sammoser) • for MDS Applications: display name of the BlackBerry device -users This subparameter specifies the user accounts in the specified user group.You can restrict this opt[...]

  • Page 88

    -status 33 You can use the -status parameter to display the BlackBerry® Enterprise Server User Administration Tool service status. Administration Guide -status 86[...]

  • Page 89

    Glossary 34 BlackBerry Domain A BlackBerry Domain consists of the BlackBerry Configuration Database with its users and any BlackBerry® Enterprise Server instances that connect to it. BlackBerry MDS BlackBerry® Mobile Data System CDMA Code Division Multiple Access CDO Collaboration Data Object GSM Global System for Mobile communications® GPRS Gen[...]

  • Page 90

    Provide feedback 35 To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback . Administration Guide Provide feedback 88[...]

  • Page 91

    Legal notice 36 ©2009 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®, SurePress™ and related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. GSM (Global System for Mobile communications) i[...]

  • Page 92

    TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON- PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING [...]

  • Page 93

    The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION. Research In Motion Limited 295 [...]