Create unit

Owned by Martin Gudme Søndergaard
Oct 26, 2022

Description

Creates a unit.


Syntax

CreateUnit(Byval UnitName as String, Byval UnitType as String, Byval LinkToManagementServerID as Integer, Optional Byval Status as String = "Active",Optional Byval Uuid as String = "") as Boolean

CreateUnit(ByVal unitName As String, ByVal unitType As String, ByVal linkToManagementServerID As Integer, Optional ByVal status As String = "Active", Optional ByVal uuid As String = "", Optional ByVal serialNumber As String = "", Optional unitDevicetype As String = "Unknown") As Boolean

Parameters

UnitName (String)

The name of the unit

UnitType (String)

Type of Unit

  • "Computer"
  • "User"

LinkToManagementServerID (Integer)

The Management Server ID must match the ID of an existing management server. Computers with unitDevicetype Unknown/Windows will be linked to the management server. All units will be linked to the Management Point that the server is linked to.

Status (String)

Status for the new unit;

  • "Active"
  • "Inactive"

This is a optional parameter. The default value is; "Active"

Uuid (String)

Here you can enter the guid you want to be used as the unit's uuid.
It must be in the correct format: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
This is an optional parameter. If left blank, a uuid will be automatically generated.

SerialNumber (String)

Here you can enter the serial number of the unit.
This is an optional parameter.

Unit Device Type (String)

       Here you can add the specific platform wanted. Default is Unknown, that leaves the device to determine the platform

  • Windows
  • OSX
  • iOS
  • Android
  • WindowsPhone

Return Value

Boolean. The function returns True if successful, otherwise false.


Example

VBScript
Set oCMS = CreateObject("CapaInstaller.SDK") 
wscript.echo oCMS.SetDefaultManagementPoint("1") 
Wscript.echo oCMS.CreateUnit("Client1","computer","1","Active") 
Wscript.echo oCMS.CreateUnit("iPhone20","computer","1","Active", "", "", "iOS")