Command Line Operations

You can interact with the Portals application through the command line, the following actions are available:

  • Create a New Portal
  • Apply a Layout
  • Apply a Settings Profile

Prerequisites:
The app must already be running

The syntax is as follows:

<portals_install_location>\Portals.exe -a <action_number> <additional_args>

The action numbers available are:

1 – Create New Portal
2 – Apply a Layout
3 – Apply a Settings Profile

1 – Create New Portal

The action number for creating a new Portal = 1.

The additional args are:

  • Path (p) – the folder path the portal will be linked to.
  • XPos (x) – the x position on the screen.
  • YPos (y) – the y position on the screen.
  • Width (w) – the portal’s width.
  • Height (h) – the portal’s height.
  • CreateFolderIfNotExist (c) – if they folder specified in -Path does not exist, create it.

Examples:

Create a Portal with a folder with default name, position and size:

<portals_install_location>\Portals.exe -a 1 -c

Create a Portal from the specified folder, using default position and size:
<portals_install_location>\Portals.exe -a 1 -p "C:\Users\Username\Documents"

Create a Portal from the specified folder, also specifying position and size:

<portals_install_location>\Portals.exe -a 1 -p "C:\Users\Username\Documents" -x 100 -y 100 -w 600 -h 400

Create a Portal at a specified path, also creating the folder:
<portals_install_location>\Portals.exe -a 1 -p "C:\Users\Username\New_Portal" -c

2 – Apply a Layout

The action number for applying a layout = 2

The additional args are:

  • Name (n)

Examples:

Apply a layout named “Office Setup”:
<portals_install_location>\Portals.exe -a 2 -n "Office Setup"

3 – Apply a Settings Profile

The action number for applying a settings profile = 3

The additional args are:

  • Name (n)

Examples:

Apply a settings profile named “Office Settings”:
<portals_install_location>\Portals.exe -a 3 -n "Office Settings"