Variables
  • 27 Nov 2023
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Variables

  • Dark
    Light
  • PDF

Article Summary

Variables give you the tools to be as dynamic as possible, and can be used within actions and filters.
Variables can currently be defined on 3 different levels;

  • Variables (Zone)
  • Contexts
  • Packages (Snapshots)

The inheritance flows top-down and variables can be overwritten. This means a variable defined at the zone level can be overwritten in contexts and/or packages. This allows you to change the value of variables based on the context(s) of a user or device.

The syntax of a variable is ${<VARIABLE NAME>}

System Variables

The following system variables are predefined in Liquit Workspace and are detected by the Agent.
Some of them are only available starting a specific version of the Agent and it is specified where applicable.
Note that the paths used as examples in the table below, might not match your environment.

VariableOutput (Example)
${AllUsersProfile}C:\ProgramData
${AppData}C:\Users\< Username >\AppData\Roaming
${CmdLine}Command-line parameters that can be passed from the Workspace API or shellapi when launching a package.
${CommonDesktop}C:\Users\Public\Desktop
${CommonProgramFiles}C:\Program Files\Common Files
${CommonProgramFiles32}On 32-bit systems this path is set to C:\Program Files\Common Files
On 64-bit systems this path is set to C:\Program Files (x86)\Common Files
${CommonProgramFiles64}C:\Program Files\Common Files
This variable is only available on 64-bit systems
${CommonPrograms}C:\ProgramData\Microsoft\Windows\Start Menu\Programs
${CommonStartMenu}C:\ProgramData\Microsoft\Windows\Start Menu
${ComputerName}Computer name of local device, same as %COMPUTERNAME%
For example: DESKTOP-123456
${CommonStartup}C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup
${Desktop}C:\Users\< Username >\Desktop
${Device.Address}Primary IP of device as reported by the agent.
For example: 10.1.1.1
${Device.FQDN}Fully qualified domain name of device.
For example: DESKTOP-123456.liquit.com
${Device.Name}Active computer name of device.
For example: DESKTOP-123456
${Documents}C:\Users\< Username >\Documents
${Favorites}C:\Users\< Username >\Favorites
${FontsDir}C:\Windows\Fonts
This variable is only available with 3.1 or later
${LiquitAgentDir}C:\Program Files\Liquit Universal Agent
${LiquitAgentDataDir}C:\ProgramData\Liquit\Agent
${PackageID}Contains the ID of the current package.
${PackageVersion}Contains the snapshot ID of the current package.
${PackageTempDir}Contains a temporary sub-directory for the current execution instance. The default directory is %LOCALAPPDATA%\Temp
For example C:\Users<username>\AppData\Local\Temp
${LocalAppData}C:\Users\< Username >\AppData\Local
${Platform.SessionID}Windows Session ID
For example: 2
${Platform.UserID}Windows User SID
For example: 4B296B08-6BB6-4084-A8F9-B1B1DE303E4A
This variable is only available with 3.7 or later
${Platform.UserName}The Windows User Name used to log on to the local device.
For example Administrator
${ProgramData}C:\ProgramData
${ProgramFiles}C:\Program Files
${ProgramFiles32}On 32-bit systems this path is set to C:\Program Files
On 64-bit systems this path is set to C:\Program Files (x86)
${ProgramFiles64}C:\Program Files
This variable is only available on 64-bit systems
${Programs}C:\Users\< Username >AppData\Roaming\Microsoft\Windows\Start Menu\Programs
${Public}C:\Users\Public
${SendTo}C:\Users\< Username >\AppData\Roaming\Microsoft\Windows\SendTo
${StartMenu}C:\Users\< Username >\AppData\Roaming\Microsoft\Windows\Start Menu
${Startup}C:\Users\< Username >\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
${SystemDrive}C:
${SystemRoot}C:\Windows
${TaskBar}C:\Users\< Username >\AppData\Roaming\Microsoft\Internet Explorer\Quick Launch\User Pinned
${TEMP}C:\Users\< Username >\AppData\Local\Temp
${UserDomain}The Windows Domain used to log into the local device.
For example LIQUIT
${UserName}The Windows User Name used to log into the local device.
For example Administrator
${UserProfile}C:\Users\< Username >
${WinDir}C:\Windows
${WinSysDir}C:\Windows\System32
${WinSysDir32}On 32-bit systems this path is set to C:\Windows\System32
On 64-bit systems this path is set to C:\Windows\SysWOW64
${WinSysDir64}C:\Windows\System32
This variable is only available on 64-bit systems

Identity Variables

The following identity variables are predefined in Liquit Workspace, are detected by the Agent and Liquit Workspace Server and contain information of the logged in user account.
Some of them are only available starting a specific version of the Agent and it is specified where applicable.

VariableOutput (Example)
${Identity.ID}Unique user ID of the currently logged in account.
${Identity.UserName}Username of the currently logged in account.
${Identity.DisplayName}Display Name of the currently logged in account.
${Identity.Mail}Mail address of the currently logged in account.
${Identity.Source}Identity Source name of the currently logged in account.
${Identity.UserPrincipalName}User Principal Name of the currently logged in account.

Was this article helpful?