Container functions
Container functions let you read and configure CapaInstaller container settings from a script, including the DLL version, schedules, database settings, management points, and the array-list splitter.
In this section
Section titled “In this section”- Get dll version - Gets the version of the DLL.
- Get schedule - Gets schedule information.
- Set database settings - Sets database settings.
- Set instance management point - Sets an instance management point.
- Set splitter - Sets the array-list splitter.
Typical start of an SDK script
Section titled “Typical start of an SDK script”Most scripts start with the same steps:
- Create the SDK object with
CreateObject("CapaInstaller.SDK"). - Optional: call Set splitter if you want another separator than
|. - Optional: call Set database settings. If you skip it, the SDK uses the database connection saved for the current Windows user, for example by the CapaInstaller Console.
- Call Set instance management point to select the Management Point that the other functions work on.
The SDK uses the CapaInstaller security rights of the Windows user who runs the script. Some functions, for example Delete group, fail if the user doesn’t have the required rights.
Errors and logging
Section titled “Errors and logging”When a function fails, for example because a unit, group, or profile doesn’t exist, it raises a script error with a description of the problem. In VBScript, use On Error Resume Next and check Err.Number and Err.Description if your script must continue after an error.
The SDK also writes errors and other information to the log file SDK.log in the folder %ProgramFiles%\CapaInstaller\Logs\SDK on the computer that runs the script.