Blackberry SWD-504685-0330050601-001 manual String value requirements, Use cases, Example

Page 16

Administration Guide

Compatibility of authentication methods with previous versions of the BlackBerry Enterprise Server User Administration Tool

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 This runs the following command:

BESUserAdminClient -username smoser -password password1 -ad_auth -domain test.rim.net -status

String value requirements

To specify -set_client_auth values that contain characters in double quotation marks, you must surround the entire string with double quotation marks. You must use a set of quotation marks to escape every embedded set of characters that are in double quotation marks.

Example: Using double quotation marks to specify a work location nickname for a user

If you have two users with the same name, Sam Moser, one of whom works in Waterloo and the other in New York, you can specify the work location for the user as a nickname.

BESUserAdminClient -username "Sam \"Waterloo\" Moser" -password password -status You store this option and value in the Windows® registry using the following command:

BESUserAdminClient -set_p password1 -set_client_auth "-username ""Sam \"\"Waterloo\"\" Moser"" -password password"

Use cases

In all the following examples, you log on to the computer that hosts the BlackBerry® Enterprise Server User Administration Tool using the following credentials:

•User name: NTLMU1

•Password: NTLMP1

Example: Running a command using SQL authentication

You log on to the computer that hosts the BlackBerry Enterprise Server User Administration Tool using the following credentials:

•User name: SQLU1

•Password: SQLP1

14

Image 16

Contents Administration Guide SWD-504685-0330050601-001 Contents Sending notification messages to BlackBerry devices Input, output, and user feedback parameters Setuseritpolicyrule Overview BlackBerry Enterprise Server User Administration ToolEdit a group across Group Delete a software Configuration Create an application Create a software Configuration View a softwareTemplate View a job Service instance View push rules for Service View pull rules forAdd and remove a role across organizations New in this releaseTool Description BlackBerry Enterprise Activation Inputfilename PasswordOutputfilename Servername Supported authentication models Authentication credentialsSyntax for authentication credentials User name SQLU1 Password SQLP1 String value requirementsUse cases ExampleFollowing command BESUserAdminClient Setclientauth -basauth -setp password1Setclientauth -username BASU1 -password BASP1 -basauth -setp password1Re-install the service using the new client password Managing user accounts Adding user accountsAdd a new user account to the BlackBerry Enterprise Server UsernameAssign a software configuration to a user account Username Sw configurationnameAdd a new user account to a group Add an existing user account to a groupChanging and removing user accounts Finding user accountsFind a user account Delete a software configuration from a user account Move a user account to a different user groupDelete a user account from a group Username InstanceChange user account settings Delete a user account from the BlackBerry Enterprise ServerList the groups in a BlackBerry Domain Managing email message forwarding Turn on or turn off email message forwardingTurn on or turn off email message forwarding for folders Managing IT policies and IT policy rules List the IT policy rules in an IT policySet IT policy rules for a user account Managing BlackBerry devices Set a password for a BlackBerry deviceSet owner information on a BlackBerry device Resend a service book Delete pending messagesResend the peer-to-peer encryption key Protect a stolen BlackBerry deviceSend a notification PIN message Username or Groupname InstanceInfofile filename or Subject subjectlinetext Body messagebodytextSend a notification email message BlackBerry devices Retrieving user account statistics and information aboutRetrieve user account statistics Results of a statistics query for a user accountColumn Description ServerDN That is associated with the BlackBerry devicePIN of the BlackBerry device Device Type Model number of the BlackBerry device StateClear user account statistics Retrieve enterprise activation statistics for a user accountRetrieve enterprise activation statistics for a user account Retrieving BlackBerry device information Retrieve the statistics for BlackBerry devicesResults of a statistics query for a BlackBerry device Users userdeviceinformation Groupname InstanceColumn Description User Name Name of the user account Home CarrierSoftware configuration on the device Uptime Time since the BlackBerry device was last resetColumn Description IT Policy Time System StatusMessaging server Enterprise Server instance Instance sentInstance filtered Administration Tool Troubleshooting the BlackBerry Enterprise Server UserConfiguring log files Yyyymmdd is the dateWarn Error Fatal Using the command summary in the help file Common parameters Input, output, and user feedback parameters Subparameter DescriptionBES1,USER2,GROUP1,false BES1,USER7,GROUP2,trueWith the BlackBerry Administration Service Error This level is not currently usedBe one of the following types Well as messages of earlier levelsAdd BlackBerry Administration ServiceGroupWise Itpolicy ITpolicyname OryWt expiry time Assignswconfig Subparameters -assignswconfig DescriptionCsw configurationname Cannot use this subparameter with -swUtype type Change Syntax -changeThis subparameter clears the users email message filters BlackBerry Enterprise Server for Novell GroupWiseEnterprise Server for Novell GroupWise AccountPurgependingmessages Account to -add or an existing user account to -changeFrom Password Subparameter Description CanonicalnameAdministration Tool does not find the mailbox DeleteSubparameters -delete Description ForceAdministration Guide Find Subparameters -find DescriptionHandheldinfo Subparameters -handheldinfo Description Appname Work with the -u or -b subparametersAction. It works with the -u subparameter HhstatsSubparameter Description Users Instead of one user accountKillhandheld Subparameters -killhandheld DescriptionAdministration Guide List Apppolicyname Instance ConfigurationnameItpolicy IT policyname Displayname Subparameters -move Description MoveMove the account to Administration Guide Subparameters -resendpeertopeerkey Description ResendpeertopeerkeyAction Resendservicebook Subparameters -resendservicebook DescriptionBody bodytext SendemailInfofile filename.txt Utype type Sendpin Subparameters -sendpin DescriptionThis subparameter specifies the body of the PIN message This subparameter specifies the name of the user groupDisplayname Default authentication type SetclientauthInterchangeably with -password Exchange messaging serverCredentials in the Windows registry Sqluser usernameSetfolderredirection Subparameters -setfolderredirection DescriptionServer for Novell GroupWise Foldername foldernameUsername Setownerinfo Subparameters -setownerinfo DescriptionInfo ownerinformation Infofile infofile.txtUtype type Setpassword Subparameters -setpassword DescriptionSubparameters -setuseritpolicyrule Description SetuseritpolicyrulePolicyrule policyrulename Administration Guide Service This subparameter specifies service instances StatsSubparameters -stats Description Email emailinstanceUtype type Status Glossary Provide feedback Legal notice Administration Guide Administration Guide