Modules
Sign in
Get Help

Get Device Value

In a workflow, you may want to test if a condition is met on the targeted device. It can be if a Service or Process is running if a specific file exists, or if a user is currently logged on to the device. The Workflow Action Get Device Value will help you query for various conditional states and create variables to be used within the Workflow as Conditions.
In the example below we are asking the Device to check if the Print Spooler Service is running on the Device and take Conditional actions based on the response. 

image 5.png

image 6.png

Available Get Device Value Workflow Actions


Services and Applications

  • Is Process Running: 
    • Get if one or more Processes currently are running on the Device as a Boolean type. Add the Process in the filename.exe format and press enter to validate. If multiple Processes are added, at least one must be running for the Boolean value to be Yes. 
  •  Service Running: 
    • Get if one or more Services currently are running on the Device as a Boolean type. Add the Service in a short name format, like spooler and press enter to validate. If a single specified Service does not exist, the Boolean value will be No. If multiple Services are added, at least one must be running for the Boolean value to be Yes.  

Users

  • Is User Logged On: 
    • Get if the user currently is logged on to the console as a Boolean type. Specify one or more users by username and press enter to validate after each. Leave the field empty to accept any current user as a list. If at least one listed user is logged on, the Boolean value will be Yes. If no listed user is logged on, the Boolean value will be No. 
  • Is User Active: 
    • Get if the user currently is logged on to the console as a Boolean type. Specify one or more users by username and press enter to validate after each. Leave the field empty to accept any current user as a list. If at least one listed user is logged on, the Boolean value will be Yes. If no listed user is logged on, the Boolean value will be No. 
  • Has User Confirmed: 
    • Ask the current user logged on to the console for confirmation based on a custom message as a Boolean type. If the user confirms with Yes, the Boolean value will be Yes. If the user confirms with No, timeout is exceeded or no current user logged on to the console, the Boolean value will be No. 

Registry

  • Registry Key Exists:  
    • Get if a specified Registry Key exists as a Boolean type. Specify one or more complete Registry paths including the Key and press enter to validate after each. If multiple Registry paths are entered, at least one has to exist for the Boolean value to be Yes. If no listed Registry Keys exist, the Boolean value will be No.
  • Registry Value:  
    • Get a specified Registry Value as Text type. Add the complete Registry path including the Key to get the Value from and press enter to validate. If the Value or Key does not exist, the Action will fail. 

File System

  • File Exists: 
    • Get if one or multiple files exist in a path on the Device as a Boolean type. The file path supports Workflow and environmental variables. File path defaults to Working Directory if no path is entered.” Add file to be tested in the filename.type format and press enter after entry to validate. Multiple files can be added and they all must exist for the Boolean value to be set to “Yes.  
  • File Time Stamp: (Change to “File Last Modified”)
    • Get when a file was last modified in UTC timezone as a Date type. Add the file in filename.type format and press enter to validate. The file path supports Workflow and environmental variables. The file path defaults to Working Directory if no path is specified. 
  • File Contains:
    • Get if a file contains a specific string of text as a Boolean type. Add the file in filename.type format and press enter to validate. The file path supports Workflow and environmental variables. The file path defaults to Working Directory if no path is specified.
  • File Version:  
    • Get the file version as Text value. Add the file in filename.type format and press enter to validate. The file path supports Workflow and environmental variables. The file path defaults to Working Directory if no path is specified. 
  • File Size:  
    • Get the size of a file in GB as a Number type. Add the file in filename.type format and press enter to validate. The file path supports Workflow and environmental variables. The file path defaults to Working Directory if no path is specified. 
  • File Content :
    • Get the first 2048 characters of a file as Text type. Add the file in filename.type format and press enter to validate. The file path supports Workflow and environmental variables. The file path defaults to Working Directory if no path is specified.
  • Working Directory :
    • Get the Working Directory temporary folder path C:\ProgramData\Kaseya\VSAX\Working” as Text type. 

General

  • Constant Value:
    • Create a constant value as String, Number, or Date type. 
  • Get CPU Architecture: 
    • Get the CPU Architecture of the Device as Text type. The currently available responses are “X86”, “X64” and “UNKNOWN”. 
  • Is OS 64- bit:
    • Boolean type value set to “Yes” if the Device is running a 64-bit OS, “No” if 32-bit. 

Examples

Check if the Spooler Service is running

  1. In the Workflow, add a new step and select Get Device Value Workflow Action. Select the variable value Is Service Running in the drop-down list. Name the variable Is Spooler Running.  Yes, variables can have spaces in the name. Type spooler as the variable value and press Enter to validate. Click Confirm to continue. 
    Tip: You can add multiple Services to be queried. The returned value is Yes if one or more specified Services in the list are running and No if all specified Services are not running. 

    Image 7.png
  2. Add a new condition step and select Variable value Is Service Running is equal to Yes. Now you can build your Automation based on whether the spooler Service is running or not.
    Image 8.png

    Ask the current user for permission to reboot 
  3. In the Workflow, add a new step and select Get Device Value Workflow Action. Select the variable value Has User Confirmed in the drop-down list. Name the variable Can We Reboot The Computer.
  4. In the Question field, use this sample text: "Greetings. It has been more than 10 days since you rebooted your computer. We recommend rebooting once a week to maintain performance and keep your computer up to date with the latest security updates. Can we reboot now? Regards, your IT Team.”   

    Image 9.png
  5. Please note, that the Yes and No text buttons are not yet customizable in the current release. 
  6. Enter a preferred timeout for the message box, 300 seconds is the max value. If the user does not answer the question within the timeout, the default answer will be No. Click Confirm to continue. 
  7. Add a new condition step and select Variable value Can We Reboot The Computer is equal to Yes. Now you can build your Automation based on the user's response to your reboot request. 
    Does a specific font file exist 
    Image 10.png
  8. In the Workflow, add a new step and select Get Device Value Workflow Action. Select the variable value File Exist in the drop-down list. Name the variable Does My Font Exist. Enter the path C:\Windows\Fonts and the file name your_font_file.ttf and press Enter to validate. Click Confirm to continue. 
    Tip: You can add multiple files to be queried. The returned value is Yes if all specified files in the list exist and No if one or more files do not exist. 
    Image 11.png
  9. Add a new Condition step and select Variable value Can We Reboot The Computer is equal to No. Now you can build your Automation based on the font file not existing on the device.

    Image 12.png

 

 

 

 

Have more questions?

Contact us

Was this article helpful?
0 out of 0 found this helpful

Provide feedback for the Documentation team!

Browse this section