Skip to content

Tenants and connection

Settings → Tenancy (administrators only) has two pages: Organizations and Tenants. The selection at the top left switches between All tenants and one tenant; with several organizations you choose the organization first. Its last entry Manage tenancy … opens this page.

Organizations

Settings → Tenancy → Organizations shows the master data of your organization: Name, Short code (capitals, digits, hyphen; used in file names and tickets), Classification (Public, Internal, Confidential, Strictly confidential) and Language (language of reports, mails and documents). Your licence includes one organization; several organizations come with MSP or Enterprise. Then the page shows a list with + Organization, and an organization can only be removed while no tenant belongs to it.

Add a tenant

Settings → Tenancy → Tenants lists every tenant with Connection method, Access («Scalio Lesen», «Scalio Schreiben»), Status (Connected, Check needed, Not connected or Simulated) and Desktops and Functions; with several organizations also the Organization. The top shows how many tenants your licence allows. When the limit is reached, + Tenant is locked.

+ Tenant opens the wizard Add tenant:

  1. Name and organization: Tenant name and Domain (for example contoso.onmicrosoft.com; Atrium takes it from Microsoft once connected), with several organizations the Organization.
  2. Connection and access: the Connection method, Direct (Windows 365 and Azure Virtual Desktop through Microsoft), Hyper-V or Proxmox VE (through the Scalio Agent, with Atrium Plus), and below it the connection (see below).
  3. Atrium settings: the functions that change desktops, and «Scalio Schreiben» (see Functions and «Scalio Schreiben»).
  4. Review: a summary. You can change everything later in the list.

Edit or remove a tenant

Each row has two buttons. Edit (pencil) opens the tenant with the tabs General (name, organization), Connection («Scalio Lesen») and Atrium settings (functions and «Scalio Schreiben»). Remove (bin) deletes the tenant after a confirmation (see also below).

«Scalio Lesen»: reading desktops

Atrium reads Cloud PCs with its own app registration «Scalio Lesen» in the customer's tenant. It has read permissions only. Atrium makes the certificate itself; the private key never leaves Atrium.

Click Edit on the tenant and open the tab Connection (step 2 in the wizard). Under «Scalio Lesen» there are two ways:

  • Connect with Microsoft: a Global Administrator or Privileged Role Administrator of the customer signs in. The page «Scalio Setup» creates the registration in the browser and brings the code back by itself. Scalio stores no sign-in and no token.
  • Show setup script: the administrator runs the script in the Azure Cloud Shell (PowerShell) or in PowerShell 7 with the module Microsoft.Graph. The script shows the permissions first. Running it again is safe and adds missing permissions. It prints a line that starts with SCALIO1: paste the whole line and click Connect.

Atrium then checks the connection and shows the organization. Check connection repeats the check; Missing permissions: run the script again means what it says. The certificate is renewed automatically 30 days before it expires.

Functions and «Scalio Schreiben»

Functions that change something in the tenant need a second registration, «Scalio Schreiben». It only gets the permissions of the functions you switch on under Functions that change desktops:

Function Permission Allows
Desktop actions: restart, rename, end grace period CloudPC.ReadWrite.All Restart and rename Cloud PCs, end the grace period (Desktop actions)
Assign provisioning policies to groups CloudPC.ReadWrite.All Add or remove the user groups of a provisioning policy (Assignment)
Change the size of a desktop CloudPC.ReadWrite.All Move a Cloud PC to another size (Pro edition). Uses another Windows 365 licence of the tenant.
  1. In the tab Atrium settings (step 3 in the wizard), tick the functions you need.
  2. Under «Scalio Schreiben» connect the registration the same way as «Scalio Lesen».

If you switch a function on or off later, the needed permissions can change: run the script again. Without a switched-on function there is no «Scalio Schreiben» script. The functions for Azure Virtual Desktop are on their own page: Azure Virtual Desktop.

Removing

  • Remove connection: Atrium no longer uses this registration. The certificate stays, so the same script and code work again.
  • Delete tenant: Atrium deletes the tenant with its desktops, actions and certificates.

In both cases the registrations in the customer's tenant stay: the customer's administrator deletes «Scalio Lesen» and «Scalio Schreiben» under Entra ID → App registrations.