CMS_GetDeploymentTemplateVariable

Description

Returns a variable from the deployment template from which the client was installed. Alternatively, the template is fetched from the business unit that the client was linked to at installation time.

Syntax

• VBScript
• PowerShell

CMS_GetDeploymentTemplateVariable(Section, Variable, MustExist) As string

[string] CMS_GetDeploymentTemplateVariable -section <string> -variable <string> -mustexist <bool>

Parameters

Section (String)

The name of the section in the template

Variable (String)

The name of the variable to return

MustExist (Boolean)

TRUE if the variable must exist

Return value

The function returns a boolean, indicating if the call was successful. If the requested section and/or variable is not present, then false is returned, unless MustExist is set to false. The requested value will be stored in gsValue. If the variable can be read, then gbValue will be set to TRUE, otherwise, it will be set to FALSE.

Result will be returned as the result of the function. If the requested section and/or variable is not present then an error is thrown, unless MustExist is set to false.

Example configuration

• JSON

{
  "operatingSystem": {
    "ImageId": 13,
    "diskConfigId": 1,
    "localAdmin": "true",
    "password": "15aarest"
  },
  "domain": {
    "joinDomain": "CAPADEMO.LOCAL",
    "domainName": "CAPADEMO.LOCAL",
    "domainUserName": "ciinst",
    "domainUserPassword": "dftgyhuj",
    "computerObjectOU": "OU=Computers,OU=Lazise,OU=Dev2,DC=CAPADEMO,DC=local"},
  "title": "Default",
  "customValues": [{
    "key": "a",
    "value": "1"
  }]
}

Example

• VBScript
• PowerShell

'Variable exists:
If bStatus Then bStatus = CMS_GetDeploymentTemplateVariable("domain", "domainUserName", True)
'This will set bStatus = true, gbValue = true and gsValue = "ciinst"

'Root variable:
If bStatus Then bStatus = CMS_GetDeploymentTemplateVariable("", "title", True)
'This will set bStatus = true, gbValue = true and gsValue = "Default"

'Custom variable:
If bStatus Then bStatus = CMS_GetDeploymentTemplateVariable("CustomValues", "a", True)
'This will set bStatus = true, gbValue = true and gsValue = 1

'bMustExist:
If bStatus Then bStatus = CMS_GetDeploymentTemplateVariable("domain", "publishedAuthority", True)
'This will set bStatus = false, gbValue = false and gsValue = ""

$var = CMS_GetDeploymentTemplateVariable -section "domain" -variable "domainUserName' -mustexist $true
#This will set $var = "ciinst"

#Root variable:
$rootvar = CMS_GetDeploymentTemplateVariable -section "" -variable "title" -mustexist $true
#This will set $rootvar = "Default"

#Custom variable:
$custom = CMS_GetDeploymentTemplateVariable -section "CustomValues" -variable "a" -mustexist $true
#This will set $custom = "1"

#bMustExist:
$fail = CMS_GetDeploymentTemplateVariable section "domain" -variable "publishedAuthority" -mustexist $true
#This will throw an exception since 'publishedAuthority' does not exist

Scripting Guidelines

Related functions

Constants Package Property Variables Business Unit support