Settings
Top  Previous  Next


Settings are used in the [Settings] section to provide parameters for some SamAccount commands, to define general static command parameters and to set general SetupBatcher operational settings.

·SamAccount settings  
·RAS settings  
·General SetupBatcher settings  
·Password generator settings  
·Text generator settings  
·SamAccount username generator settings  
·Print [Data] settings  
·User defined SET settings  
·Linux settings  



SamAccount settings
Used by Account.Create and Account.Edit.  

Setting
Description
Account.Description.Col
1-30

Column in the [Data] section from which description is imported. Maximum description length: 48 characters.

"Account.Description.Col=1" and "Account.Description=%col1%" is the same thing.
Account.Description
Description string

Use "Account.Description" to set identical descriptions or to combine descriptions from columns in [Data] during a script.

Examples
·Account.Description=Same for all  
·Account.Description=%col1%  
·Account.Description=%col1% %col2%  
Account.Disabled
Yes | No

Disable / Enable accounts
Account.Expires
YYYY-MM-DD | never | %colX%

Use %colX% to import from [Data] section.
Account.FullName.Col
1-30

Column in the [Data] section from which full name is imported. Maximum length of full name: 48 characters.

"Account.FullName.Col=1" and "Account.FullName=%col1%" is the same thing.
Account.FullName
Full name string.

Use "Account.Description" to set identical full names or to combine full names from columns in [Data] during a script.

Examples
·Account.Description=Same for all  
·Account.Description=%col1%  
·Account.Description=%col1% %col2%  
Account.HomeDir
Full path

Each users home directory, usually connected to with the SUBST command. About home directories for different Windows clients.

Examples
·Account.HomeDir=c:\users  
·Account.HomeDir=%servername%\%col1%$  
Account.HomeDirDrive
Home dir drive letter
Account.LogonHours
Account to copy setting from

Copies logon hours setting from an existing account. Example
Account.Password.CannotChange
Yes | No

Sets / clears "User cannot change password".
Account.Password.Col
1-30

Column in the [Data] section from which password is imported. Maximum password length in NT is 14 chars. The password must be at least as long as the minimum length specified in your account policy.

Notice: Account.Password.Col is ignored by Account.Edit - Account.Edit does not change password.
Account.Password.MustChange
Yes | No

Sets / clears "User must change password at next logon".
Account.Password.NeverExpires
Yes | No

Sets / clears "Password never expires".
Account.ProfilePath
User profile path
Account.ScriptName
Logon script name

The logon script is a batch file (usually located in systemroot\system32\repl\import) that, if present, will be executed every time a user logs on. This script can be used to create home dirs, connect network drives, set system time and environment variables etc.
 

RAS settings
Used by Account.Set.RAS  
 
Setting
Description
Account.RAS.CallBack
No | Bycaller | Preset
Account.RAS.CallBack.Phone
Preset Phone number
Account.RAS.GrantDialin
Yes | No
 

General SetupBatcher settings
Setting
Description
BatchSettings.AddToValidCharSet
Normally, SetupBatcher only allows English characters, but you can add local letters by specifying them here. For more information see the file "noneng.cnu".
BatchSettings.AutoRetry
10-86400

Time between retries for auto retry in seconds. 86400 = 60x60x24 = one day.

Specify a value to enable auto retry. Remove the setting to disable auto retry.
BatchSettings.CheckMachines
Yes | No

Disables [Machines] section pre-scan.
BatchSettings.CommandDelimiter
, | ;

Command parameter delimiter - the character that is used between parameters in commands.
BatchSettings.Debug
Yes | No

Set to yes to debug a script:

·The script is not hidden while running.  
·DOS / DOSR: A dialog is displayed before every command. Output from successful commands is also displayed in the log.  
·Command line mode: SetupBatcher runs the batch job and remains in GUI mode when finished. %errorlevel% is displayed in the status window but is not returned when the program exits.  
BatchSettings.Delimiter
TAB | , | ; | :

Delimiter for the [Data] section. The TAB character is used in most examples. (It is possible to copy and paste data directly via the clipboard from spreadsheets like Excel when TAB is used.)
BatchSettings.ErrorDialogDisable
Yes | No

Disables the abort / retry / ignore error dialog in GUI mode. This is useful when errors should be handled by the [OnError] section in GUI mode.
BatchSettings.IgnoreErrors
Yes | No

When an error occurs, no error dialog is displayed and the script continues. Errors are still displayed in the log.
BatchSettings.LogCommands
Yes | No

Displays all executed commands in the Log window.
BatchSettings.LogToFile
0-3, default 0

·0 - do not log anything  
·1 - save the log window when the script is finished.  
·2 - save the script when the script is finished.  
·3 - save the log window and the script when the script is finished.  

Files are saved in %StartDir%\log
BatchSettings.MarkerCol
1-30

[Data] section status column. Used by SetupBatcher for markers.
BatchSettings.MarkersAutoRemove
Yes | No

Yes = automatically remove all markers before the script starts.
BatchSettings.UndoCommandsInBatch
Yes | No

Set to yes to allow mode 3 and 4 [Undo] commands in the [Batch] section.
 

Password generator settings
Used by Data.Passwords.Generate, GUI: click action > run password generator.  
 
Setting
Description
Generator.Password.DestCol
Password generator destination column.
Generator.Password.Random.Chars
Random password generator character set.
Generator.Password.Random.Len
Random password generator password length.
Generator.Password.Special.Consonants
Pronounceable password generator character set.
Generator.Password.Special.File
Pronounceable password generator word file 1. One word per row.
Generator.Password.Special.File2
Pronounceable password generator word file 2. One word per row.
Generator.Password.Special.Format
Pronounceable password generator format.
Generator.Password.Special.Numbers
Pronounceable password generator character set.
Generator.Password.Special.Special
Pronounceable password generator character set.
Generator.Password.Special.Vowels
Pronounceable password generator character set.
 


Text generator settings
GUI: click action > run text generator  
Notice: Data.Column.Fill does the same thing but does not use the below settings.  
 
Setting
Description
Generator.Text
Text to fill specified column with.
Generator.Text.DestCol
Text generator destination column.
     

SamAccount username generator settings
Used by Data.Usernames.Generate, GUI: click action > run username generator.  
 
Setting
Description
Generator.UserName.DestCol
User name generator destination column.   
Generator.Username.Series.Count
1-5000

Number of names to generate.
Generator.Username.Series.Prefix
1-14 characters

Characters to insert before number.
Generator.Username.Special.Format
Format: a,b,c,d,e

·a=source column  
·b=source word  
·c=pos (0=start, 128=end),  
·d=count  
·e=direction (0=forward, 1=backward)  

How names should be combined from [Data].
 

Print [Data] settings
Used by Data.PrintRow, GUI: click action > print data section.  
 
Setting
Description
Printer.Template
Printer template file name.
 

User defined SET settings
Use the SET command in the [Settings] section for static settings - constants, aliases.  
See the script file "general.cnu" for an example of how to use user defined settings.  

Linux settings
 
Setting
Description
Linux.Version
1-2, default 1

Decides how the Lin.DS.Group.x commands works.