Predefined Programs

• Full Inventory

The Full Inventory program checks for missing updates and then displays the hardware and software inventory that are in need of updates. It runs through a Windows Update Search (More in the Updates Section) and then a Full Inventory.

 



 

• Patch and Reboot

The Patch and Reboot program is pre-built and performs several actions. First, it checks for Wuinstall updates that might be missing. Then, using an If-loop, the program checks if there is an update in the MissingUpdate filter which is not yet installed or if a reboot is necessary. If this is the case, the program performs a reboot in the form of a Do-While-loop and installs the missing updates, as long as less than 3 reboots have been made and necessary updates are missing. Once the loop is completed, a reboot is done again, and the hardware and software inventory are displayed.

 



 

• Patch and reboot if required

The Patch and reboot if required program asks with an if loop whether a reboot is necessary. for the update If it is, a message is displayed indicating that an update is required. An update is performed 5 minutes after the message is displayed. Once the loop is completed, the program searches for and installs missing updates and displays the hardware and software inventory.

 

• Update XEOX Agent

As the name suggests, it is a pre-build program that updates the installed XEOX agent. It automatically updates to the current version of the agent, but you can also select the release candidate or long time support too.

• Windows 10 2004 Upgrade

Windows 10 2004 is a big update of Windows 10 that cam out in 2020. With this pre-defined program from the toobox, you install updates up to the point of this version on your computer.

Updates

• Download Windows Update

Download Windows Update only downloads update packages but does not install them.

There are several settings to costumize the download to your comany needs.

The first setting is selecting the Source. The selection is between all Microsoft Updates (Windows + other Microsoft products), Group Policy Defaults (settings that additionally control how/when/where updates are applied), WSUS Updates (Updates controlled by your organization’s WSUS server, instead of directly from Microsoft.) and Windows Updates (Windows OS patches).

Severity, Classification and Products let’s you select tags, that will filter which updates will get installed or not. For example: Selecting Severity C (Critical) only critical update packages will be downloaded. Additionally there is the option to add update lists.



 

• Install Windows Update

Install Windows Update updates if they are not already downloaded and installs them afterwards. If the update is already downloaded it will only be installed. For further explaination of the individual settings see above in Download Windows Update.

• Search Windows Update

Search Windows Update searches for missing updates. This information (open updates) is then displayed in the Update Center. For further explaination of the individual settings see above in Download Windows Update.

Scripts & Software

• Create file

With Create file it is possible to create and download a file in the web interface of XEOX. It is very useful to create small text files for a software installation without the need of a web server. e.g.:

• BAT files for the installation
• PowerShell files
• License files

• Download

Downloads a file via http/https. You can enter as many URL as you want by clicking the plus button.

• Download (legacy)

Downloads a file via http/https and Hash. Possible sources:

• Public web server. e.g. download software directly from the manufacturer's site.
• Private webserver which is located on the internet. Can be secured with http username/password.
• Internal web server. e.g., a NAS (Network attached Storage). If your company has multiple sites, variables can be used to refer to local servers per site.
• URL: A download is attempted in chronological order. This can be used to achieve a download fallback, for example.
• URL Internal server: is used by all devices that are in the internal network and saves the WAN line.
• URL external server: for all devices that are external this fallback is used.
• Filename after download: Often it happens that the filename contains the version number. In case of a version update, the following workflow would have to be adapted. With the Filename after download option, it is possible to always use the same name for the subsequent workflow.
• Download Directory: By default, the file is stored in the working directory of the XEOX agent. This directory will be cleaned up by the agent automatically after the job is finished. Alternatively, any directory can be specified. See: Working Directory (Please create your own KB article).
• Authentication: The download can be secured with a user/password.
• Proxy: A proxy server (optionally with authentication) can be specified. In case of multiple sites, variables can also be used here.

If the software consists of several files, you have to use either more than one download action (for legacy, you can alternatively use the other download, where you can enter multiple files) or pack the software into a ZIP file.

• Execute

With execute you can execute a bat or exe file on the client. The file can be:

• downloaded before
• already be in the system
• a Windows system function

By clicking Specify working directory the command prompt will be seperated in different sections, Working Directory, Executable, Arguments

• Get file info

By entering a filename, information about the file will be displayed. It works similarly to execute, without the Specify working directory option. The plus button allows to add several files to get information on.

 

• Gunzip

Unzips a Gziped folder. For Unzipping a normal Zipped file, see Unzipped. Just enter the file name (including path optional).

• Gzip

Gzips a folder. For Zipping a file (NOT Gzio) see Zip. Just enter the file name (including path optional).

• Run script

Runs a script either by writing one or using a script that was previously created under scripts.

Writing one let’s users choose between Batch, Powershell or ShellScript and whenever or not to run the script as a logged in user.

• Run Job Template

Runs a Job Template that was previously created with Execute. More information here. There is also an opportunity to create a seperate automation, which will be asynchronous, if you check the Create Seperate Automation checkbox.

• Stop Process

This allows users to stop a process by entering the name of said process. The system will then search for it and stop said process.

• Unzip

Unzips a zip folder. Optionally a ZIP file can be encrypted additionally with a password. This is helpful if you want to use a public web server as a repository for the software. Supported formats:

• ZIP
• TAR
• RAR
• CAP
• ISO

• Wait for file to exist

By determinating a file name, the automation will wait until this file exists before doing anything. Enter the name of the file or files that needs to exist. The plus button allows adding more than one file.

• Wait for process to finish

If a process is running during you automation this function will ensure it is finished. If the process has not started yet, but has to be finished before the next step, make sure to check the checkbox, this will ensure the process is started and finished before moving on. Enter the name of the affected process to make it work.

• Wait for process to start

This will wait for a process to start until continuing. If it is finished or not does not matter here, so if the desired outcome is for the process to finish before moving on, use Wait for process to finish instead. Enter the name of the affected process to make it work.

• Zip

It is possible to Zip files here, by entering the file path (multiple selection possible by clicking the plus button) and naming for the zip file.

Software

• Install chocolatey bundle

This will allow you to install bundles using chocolatey, the dropdown menu allows user to select the bundle to install. Additionally the checkbox allows for downgrades.

• Install chocolatey package

This will allow you to install packages using chocolatey, the dropdown menu allows user to select the package to install, and the next field allows to select the version of the package. Additionally the checkbox allows for downgrades.

• Upgrade chocolatey bundle

This will allow you to upgrade already installed bundles using chocolatey, the dropdown menu allows user to select the bundle to upgrade. Additionally the checkbox allows for downgrades, as well as skipping not installed parts.

• Upgrade chocolatey package

This will allow you to upgrade already either all packages or selected packages using chocolatey. Upgrading all packages is the default, the checkbox additionally allows to exclude packages. Once checked another dropdown menu will appear where packages can be selected. The plus button allows for more packages to be selected. Once switching to Upgrade Packages allows you to select a package to upgrade and the next field allows to select the version of the package. Additionally the checkbox allows for downgrades, as well as skipping not installed parts.

Client

• Agent Cleanup

Agent Cleanup clears the log, wuinstall and work directory of the agent.

• Agent Restart

Restarts the agent.

• Agent Uninstall

Uninstalls the agent.

• Agent Update

The agent will be updated, here you can decide which version you want to install and if you want to have a stable update (current), long time support or a test update (release candidate). Furthermore there is a possibility to chose the version of the update.

 

• Chocolatey Inventory

Chocolatey Inventory is a list of hardware for the computer. It contains for example:

• Anti Virus Product
• Battery
• Bios
• CD-ROM Drive
• Computer System
• Computer System Product
• Desktop Monitor
• Drive
• Network Adapter
• Operating System
• Physical Memory
• Printer
• Processor
• Service
• Software
• Software License
• Sound Device
• System Enclosure
• Video Controller

• Reboot

Reboots the client. You can set the time of the reboot by either specifying how many minutes later the reboot should take place, entering an exact date with time or setting it to random (e.g. to avoid rebooting all devices at the same second a random time should be waited before (=jitter)).

• Upload Agent Log

Uploads the logs of the agent.

Notifications

• Send Email

With Send Email you can create an email that will be sent out. If you do not enter a recipient, the email will be sent to you.

• Send Mattermost Message

Allows you to send a message via Mattermost.

• Send Windows Message

Sends a message to all logged-in users on the client. Useful to announce a reboot.

• Send Slack Message

Allows you to send a message via Slack Messenger.

• Send Teams Message

Allows you to send a message via Teams.

Flow

• abort

With abort an error message is displayed, and the program is aborted.

• do

Do is for a do-while loop, which means that first an action is executed, and then it is checked whether the conditions for the loop are still correct. If they are still correct, then the loop is repeated, otherwise the actions in the job continue to be processed. With do, the loop is always used at least once.

• else

Else is mostly used in combination with an if loop. It indicates that if the other conditions are not true, then the else condition is accessed.

• finish

Finish, in contrast to else, is always executed, no matter if if or else is used, if a finish is present, finish is added to the applicable condition.

• if

An if loop is used to check if a condition is true. Íf this is the case, the actions in the loop are processed, otherwise they are simply skipped.

• sleep

Stops the program for a certain time. You can either choose how many minutes it takes, when it should be over, randomly or with a trigger.

Others

• Add tags

With this function you can add tags to the hardware that is affected by the job.

• Remove tags

With this function you can remove tags from the hardware that is affected by the job.

• Upload file

Upload file is used to upload a document from client to the XEOX portal, e.g., a log file. This file can be displayed under "Hardware - Files".

Events