Interface de ligne de commande de Devolutions Server Console

L'interface de ligne de commande (CLI) de la console Devolutions Server est un outil complémentaire qui permet aux administrateurs d'interagir avec les instances Devolutions Server, le planificateur, le serveur d'enregistrement ou une passerelle via des opérations de création, de configuration et de suppression. Elle est automatiquement disponible lors de l'installation de la console Devolutions Server. Le fichier DPS.Console.CLI.exe se trouve dans le dossier d'installation de l'application console Devolutions Server.

Utilisation de la CLI

Le commutateur /help permet de lister toutes les commandes et tous les paramètres disponibles.

Le commutateur /help peut être utilisé pour lister les paramètres d'une commande.

La commande suivante lance le processus de mise à niveau à partir d'un fichier ZIP disponible dans le dossier C:\temp.

.\DPS.Console.CLI.exe server upgrade --dps "Default Web Site/dps" --zip "C:\temp\DVLS.20XX.X.X.X.zip" --accept-eula -quiet -verbose.

La commande suivante crée une nouvelle instance Devolutions Server à partir d'un fichier de réponse JSON (voir ci-dessous) contenant les paramètres requis. Elle peut être utilisée avec n'importe quelle commande principale de la CLI.

Exemple d'un fichier de réponse JSON pour la création d'une nouvelle instance Devolutions Server.

{
  "acceptEula": true,
  "adminEmail": "[e-mail]",
  "adminPassword": "AdminPassword",
  "adminUsername": "admin",
  "appPoolIdentityType": "Network Service",
  "appPoolIdentityPassword": null,
  "appPoolIdentityUsername": null,
  "command": "server install",
  "consolepwd": "MyConsolePassword",
  "databaseHost": "SQLServer\SQL2017",
  "databaseIntegratedSecurity": false,
  "databaseName": "DSERVER",
  "databaseConsolePassword": "MyPassword",
  "databaseConsoleUsername": "VaultDBOwner",
  "databaseSchedulerPassword": "MyPassword",
  "databaseSchedulerUsername": "VaultDBScheduler",
  "databaseVaultPassword": "MyPassword",
  "databaseVaultUsername": "VaultDBRunner",
  "debug": false,
  "disableEncryptConfig": false,
  "disableHttps": false,
  "disablePassword": false,
  "dpsPath": "C:\\inetpub\\wwwroot\\dvls",
  "dpsWebsiteName": "Default Web Site",
  "installZip": null,
  "keysPath": "C:\\temp\\DVLS_EncryptionKeys.bin",
  "keysPassword": "MyKeysPassword",
  "quiet": false,
  "scheduler": true,
  "serial": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
  "serverName": "Devolutions Server",
  "serviceAccount": "LocalSystem",
  "servicePassword": null,
  "serviceUser": null,
  "webApplicationName": "/dvls",
  "verbose": false
}

Procédure d'urgence

Un compte de secours est souvent utilisé comme mécanisme de dernier recours pour garantir que les opérations informatiques essentielles ou les fonctions de sécurité peuvent continuer en cas de panne, de défaillance du système ou d'incident de sécurité. Avec l'interface de ligne de commande de la console Devolutions Server, il est possible de désactiver l'authentification personnalisée et de l'activer à la demande si le fournisseur d'identité principal est hors service. Le compte personnalisé de l'administrateur doit avoir été préalablement créé dans l'instance Devolutions Server.

Veuillez noter que vous devez remplacer dvls (après ...\wwwroot\) par le nom de votre propre application IIS Devolutions Server personnalisée.

Activation de l'authentification personnalisée

Dans la CLI, entrez l'une ou l'autre des commandes suivantes :

server instance --instance=C:\inetpub\wwwroot\dvls --enable-custom-authentication=true

ou

server instance --instance=C:\inetpub\wwwroot\dvls --custom-auth=true

Désactivation de l'authentification personnalisée

Une fois les opérations nécessaires effectuées :

server instance --instance=C:\inetpub\wwwroot\dvls --enable-custom-authentication=false

ou

server instance --instance=C:\inetpub\wwwroot\dvls --custom-auth=false