Profile Configuration


This document describes the profile.XO module in detail. All necessary information for installing, configuring, and using it is provided.

What is profile.XO?

profile.XO is an extended implementation of our PowerShell Profile Management Framework with a cloud-hosted gui and configuration backend.

How we created it

The module uses the PowerShell that combines elements from the Unix shell with object-oriented programming. Simple commands can be executed from the command line or complex scripts can be developed.

Configure user profiles using Profile Packages

In this chapter the possibilities are presented, how configured Profile Packages for Windows users can be applied. The logic for the execution of a Profile Package is integrated in the profile.XO commands in Deploy-UserPackage.ps1. We will explain how a single Profile Package can be executed manually and how the profile.XO Service handles the execution of all configured Profile Packages.

Automatic application of all configured Profile Packages via service

If the profile.XO Service has been installed on the reference system, the Profile Packages are run according to the configured trigger. A prerequisite is that the Profile Packages are located in the defined package source directory.

By default, the package source directory is located in C:\ProgramData\XOAP\profileXO\Service\PackageSource.

Every Profile Package is presented as a single folder with all the data that belongs to it.

If these Profile Packages are configured so that their trigger is the Windows logon of a user, the service steps in after entering the user name and password and runs the individual Profile Packages.

The logon process looks like this:

Abbildung: Logon-Prozess

Manual application of a Profile Package using the profile.XO Framework

Since the logic for executing a Profile Package is located in the profile.XO Framework Deploy-AllUserPackages.ps1, the Profile Packages can also be applied individually without the Service. This principle is also used by the profile.XO Package Wizard to execute a Profile Package during packaging and tests.

The steps to manually execute a Profile Package are as follows:

  • Open PowerShell and change the current working directory to the directory of the profile.XO Framework:
cd C:\Program Files\RISC_Software\PowerShell_Profile_Management\Framework

Run the following command to execute the desired Profile Package:

.\Deploy-UserPackage.ps1 PackagePath [Pfad zur .json Datei] DeploymentType [Logon oder Logoff] 

By default, the Deploy-AllUserPackages.ps1 script always displays a progress dialog. If the execution without progress dialog is desired, the command can be adapted as follows:

.\Deploy-UserPackage.ps1 PackagePath [Pfad zur .json Datei] DeploymentType [Logon oder Logoff] -ShowProgress $false