Blackberry SWD-504685-0330050601-001 Assignswconfig, Subparameters -assignswconfig Description

Page 52

Administration Guide

-assign_swconfig

-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 - display_name, email_address, login_name, canonical_name

or

-g <group name> : group name

-sw <configuration name> : software configuration name or

-csw <configuration name> : remove configuration from user/group

Subparameters: -assign_swconfig

Subparameter	Description

-b <instance>	This subparameter specifies the BlackBerry® Enterprise Server instance for the action.
	You use the name of the BlackBerry Enterprise Server instance that appears in the
	BlackBerry Administration Service.
-csw <configuration_name>	This subparameter removes a software configuration from a user account or group. You
	cannot use this subparameter with -sw.
-g <group_name>	This subparameter specifies the name of the group for the action.
	This subparameter overrides the -u and -b parameters.
-sw <configuration_name>	This subparameter specifies the name of the software configuration that you want to add
	to the user account. You cannot use this subparameter with -csw.
-u <user_name>	This subparameter specifies the user account for the action. Depending on the 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®: 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

50

Image 52

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