Démarrage rapide pour déployer l'application de bureau Workspace

Ce guide couvre les étapes pour déployer l'application de bureau Workspace avec des sources de données préconfigurées Devolutions Server et Devolutions Hub Business. L'installation est gérée via un RMM, suivie par un script PowerShell pour générer le fichier de configuration nécessaire.

Pour pouvoir être ajouté, Devolutions Server et Devolutions Hub Business doivent être accessibles à partir de l'ordinateur utilisé pour la préconfiguration.

1. Installer l'application de bureau Workspace en utilisant un RMM.

2. Exécuter le script PowerShell suivant après avoir remplacé les variables par vos données.

#Requires -RunAsAdministrator

param(

    [string]$DVLS_SERVER_URL = $null,

    [string]$HUB_NAME = $null,

    [string]$ORGANIZATION_ID = $null,

)

try {

    $appDataPath = [System.Environment]::GetFolderPath('ApplicationData');

    $configFilePath = Join-Path $appDataPath 'net.devolutions\\Workspace\\Config.cfg';

    $logPath = Join-Path $appDataPath 'net.devolutions\\Workspace\\CreateConfigLog.txt';

    if (-not (Test-Path (Split-Path $configFilePath))) {

        New-Item -Path (Split-Path $configFilePath) -ItemType Directory -Force;

    }

    Add-Content -Path $logPath -Value 'Starting config file creation...';

    $hubsList = @()

    if ($HUB_NAME) {

        $hubsList += @{

            url = "https://$HUB_NAME.devolutions.app";

            organizationId = $ORGANIZATION_ID;

        }

    }

    $dvlsList = @()

    if ($DVLS_SERVER_URL) {

        $dvlsList += @{

            name = 'Devolutions Server';

            serverUrl = $DVLS_SERVER_URL;

            serverVersion = '2024.3.0.0';

        }

    }

    $configContent = @{

        hubs = $hubsList;

        dvls = $dvlsList;

        preventStartup = $true;

    };

    $json = $configContent | ConvertTo-Json -Compress;

    Add-Content -Path $logPath -Value "Config content created: $json";

    Set-Content -Path $configFilePath -Value $json;

    Add-Content -Path $logPath -Value "Config file created successfully at $configFilePath";

}

catch {

    Add-Content -Path $logPath -Value "Error creating config file: $_";

    exit 1;

}

3. Le script générera un fichier de configuration dans le dossier AppData de l'utilisateur. Par exemple:

   C:\Users\USERNAME\AppData\Roaming\net.devolutions\Workspace\Config.cfg

4. Lancer l'application de bureau Workspace.

5. Créer des espaces Devolutions Server et Devolutions Hub Business.

6. Ouvrir les espaces et s'y connecter.

Lors de l'implantation de l'application de bureau Workspace en utilisant l'installateur MSI, ajouter une source de données Devolutions Server ou Devolutions Hub Business en la fournissant en tant qu'argument lors de l'installation.

• Devolutions Server : msiexec /i "installer.msi" DVLS_SERVER_URL=https://dvlsurl.com

• Devolutions Hub Business : msiexec /i "installer.msi" HUB_NAME=workspace ORGANIZATION_ID=devolutions